本文档由 g2rain-department 的
# 故障排查
docs/operations/troubleshooting.md 自动同步生成。# 无法启动
确认 JDK 25、数据源、MySQL 数据库、Mapper 路径和当前 Profile。启用 Nacos 时检查地址、命名空间、group 和凭证。
# App 无法访问接口
确认 IAM Token、Gateway 路由、服务发现和权限配置。受信接口不能由普通 App 直接访问。
# IdP 同步失败或结果异常
检查调用主体是否为管理员、请求与主体 organId 是否一致、父部门是否在子部门之前可解析。全量模式默认不会删除；只有显式安全闸开启后才执行破坏性对账。
# 策略结果或缓存异常
从 organId、用户、部门路径、模块、表名、模型、元数据、权限组和特殊规则逐项核对。配置变化后检查 g2rain-syncer 输出绑定和消费者缓存 TTL。
# 镜像健康检查失败
应用默认监听 8085，Jib 当前声明 8080；检查实际环境变量、容器暴露端口、Service 和健康检查是否一致。