FAQ 总汇
本文档按分类汇总 Forge Admin 常见问题，帮助你快速找到答案。
安装部署
Q: Forge Admin 需要 JDK 几？
A: Java 17 或以上版本。推荐使用 Eclipse Temurin 17 LTS。
Q: 数据库支持哪些版本？
A: MySQL 8.0+。数据库必须使用 utf8mb4 字符集和 utf8mb4_0900_ai_ci 排序规则；当前初始化 SQL 不保证兼容缺少该排序规则的 MariaDB。
Q: Redis 版本有要求吗？
A: Redis 6.0+，推荐 7.0+。
Q: 可以用 Docker 部署吗？
A: 可以。参考 部署指南 中的 Docker Compose 方案。升级前备份见 备份、升级与回滚基线。
Q: Docs PRO 是不是另一套收费代码？
A: 不是。Forge Admin Open Source 包含核心代码功能。Forge Docs PRO 是深度教程和案例，不锁功能。
Q: 默认账号密码是什么？
A: admin / 123456，首次登录后请立即修改密码。
使用操作
Q: 如何新增一个菜单？
A: 进入 平台管理 → 菜单管理，点 新增顶级菜单。弹窗是「新增资源」，填资源名称、类型、客户端、路由和组件路径后保存。详见 菜单与资源。
Q: 如何给角色分配权限？
A: 进入 平台管理 → 角色管理。行上是编辑 / 适用组织 / 更多；分配菜单在 更多 里。短流程见 RBAC 权限配置。
Q: 字典数据修改后前端没生效？
A: 字典有前端缓存。清除方式：退出重新登录，或调用 useDictStore().cleanDict() 刷新缓存。
Q: 文件上传支持哪些存储？
A: 支持 MinIO、本地磁盘、阿里云 OSS，通过 file.storage.type 配置切换。
开发调试
Q: 后端启动报 Bean 循环依赖？
A: 检查 @Async 方法是否在同 Bean 内被调用，将其拆分到独立 Service。
Q: Mapper XML 修改后不生效？
A: 确认 mybatis-plus.mapper-locations 配置正确，开发环境可开启热加载。
Q: 前端代理配置在哪里改？
A: 修改 vite.config.ts 中的 server.proxy 配置，指向后端 Admin 端口 8580。
Q: 代码生成器生成的代码放在哪？
A: 生成后解压到对应模块的 src/main/java 目录下，前端代码放到 src/views 和 src/api 下。
权限租户
Q: 接口返回 403 怎么办？
A: 检查当前用户角色是否包含对应权限标识（@SaCheckPermission 注解中的值），在角色管理中分配权限。
Q: 多租户如何关闭？
A: 在 application.yml 中设置 forge.tenant.enable: false，所有数据将不再自动追加租户条件。
Q: 超级管理员和数据权限的关系？
A: 超级管理员（admin 用户）默认跳过数据权限拦截，可查看所有租户和部门数据。
流程低代码
Q: 流程设计器在哪里？
A: 进入「工作流 → 流程定义」，点击「新增流程」打开可视化设计器。
Q: 流程部署后不生效？
A: 检查流程是否已「发布」，只有已发布状态的流程才能发起新实例。
Q: AiCrudPage 如何使用？
A: 在前端路由对应页面中使用 <AiCrudPage> 组件，传入 API 路径和字段描述，组件自动生成增删改查界面。
💡 更多问题请查阅 报错索引 或 Gitee Issues。