Appearance
问题现象
在管理后台配置第三方接口、微信公众号、支付参数,或用户在前端登录进行 Token 存储时,页面弹出错误提示: 保存token失败、Token cache write failed 或 系统错误:Redis连接失败。
根本原因
EBAOZU V4 的用户鉴权 Token、会话信息及临时令牌均通过 Redis 缓存驱动 进行常驻内存存储与过期淘汰。 当 Redis 服务未启动、密码配置不一致、内存写满(OOM)或网络通信异常时,后端在执行 Token 写入时抛出异常,导致保存失败。
解决步骤
检查 Redis 服务状态
登录服务器终端,确认 Redis 服务正在正常运行:
bash
systemctl status redis || /etc/init.d/redis status若未启动,请执行启动命令:
bash
systemctl start redis核对 .env 中的 Redis 连接配置
打开项目根目录下的 .env 文件,确认 [REDIS] 配置段与 Redis 实际配置严格相符:
ini
[REDIS]
REDIS_HOSTNAME = 127.0.0.1
PORT = 6379
REDIS_PASSWORD = your_redis_password
SELECT = 0- 若 Redis 无密码,
REDIS_PASSWORD请留空。 - 若有多套系统部署,确保各套系统使用不同的
SELECT库号和独立的CACHE.PREFIX。
重启 Swoole 守护进程
在 Supervisor 管理器中重启守护进程使 Redis 客户端重新建立连接池:
bash
supervisorctl restart ebaozu_v4再次提交保存
返回后台页面重新点击保存,或重新发起登录,Token 保存异常即可消除。