本文档由 g2rain-mcp-registry 的 docs/operations/troubleshooting.md 自动同步生成。

# 故障排查

现象	检查
MCP 客户端无法发现工具	/mcp 路由、实际协议模式、工具状态、租户与授权。
调用工具失败	schema 解析、下游服务、可信上下文转发、超时和错误映射。
启动失败	profile、Nacos、MySQL、Redis 与 MCP Server 装配。
工具越权或数据异常	工具可见范围、非隔离 DAO 路径、主体/机构上下文与审计记录。