G2rain（谷雨）开源智能体平台项目文档，由 g2rain-generator-maven-plugin 的 docs/operations/troubleshooting.md 自动同步生成；正文保留来源仓库的技术表述与历史名称。

# 排障

现象	优先检查
Goal 无法解析	插件坐标、版本、仓库和 descriptor
JDBC 失败	URL、驱动、最小权限账号、网络和数据库版本
未生成表	tables、大小写、schema 和元数据权限
文件未更新	overwrite 与 skipIfExists
路径错误	projectName、basePackage、stepIn 和目标根
代码不能编译	模板、列类型、Generator/Crafter/Profile 兼容

日志不得输出数据库密码。