先判断问题发生在业务应用中,还是 Studio 的开发协作流程中,再进入对应的排错文档。
- Core 应用的开发和运行问题:插件安装后没有功能、配置不生效、数据库迁移报错、依赖升级或部署问题,先查 Core 常见问题。
- Studio 的安装和协作问题:无法登录、Git 连接失败、运行环境离线、任务不开始、检查或预览缺失,先查 Studio 常见问题与排错。
- 教程或命令与手头环境不一致:先确认阅读的是 NocoBase 3 文档。版本关系见 NocoBase 2 与 NocoBase 3,应用命令以命令行参考和当前版本的帮助信息为准。
如果仍无法定位,可以把复现步骤、实际与预期结果、相关版本以及脱敏后的错误信息交给 Coding Agent 协助排查。说明问题发生在安装、源码开发、构建还是部署运行阶段;Studio 任务问题补充相关任务及运行环境状态。不要提供密码、密钥或会话令牌。