ZCenter 登录或资源同步失败，如何确认并恢复 Redis？

问题说明

本文用于排查ZCenter因Redis不可达、认证失败、连接超时或Redis服务异常引起的登录认证、权限读取和资源同步异常。不同服务对Redis异常的最终返回结果可能不同，应以连接测试和服务日志为准。

现象

• 登录、刷新Token或访问需要认证的接口失败，可能返回401，日志中出现 Token expired、Token validation failed、Token verification failed 或 Auth error。
• 云环境资源同步未执行、同步任务重试或单个资源同步超时，日志中可能出现 resource sync get lock timeout!、Failed to acquire lock during resource sync 等关键字。
• 角色权限读取异常、页面提示无权限，或登录锁定相关行为异常。
• 服务启动或运行日志中出现Redis connection refused、timeout、authentication failure等客户端异常。具体异常文本以实际客户端日志为准。

适用环境

• 产品：ZCenter
• 版本：5.1.0
• 组件：Base、Gateway及使用Redis/Redisson的资源同步服务
• 部署形态：单节点或多服务部署；Redis地址和密码以实际运行时配置为准

可能原因

• Redis进程未运行，监听地址或端口不可达。
• 服务配置中的Redis地址、端口、密码、数据库或TLS模式与实际部署不一致。
• Redis连接数、资源或网络状态异常，导致Redisson连接超时或重试失败。
• Redis故障导致Access Token键、Refresh Token键或分布式锁无法读写；资源同步可能无法获取锁。