FAQ 总汇

本文档按分类汇总 Forge Admin 常见问题，帮助你快速找到答案。

安装部署

Q: Forge Admin 需要 JDK 几？

A: Java 17 或以上版本。推荐使用 Eclipse Temurin 17 LTS。

Q: 数据库支持哪些版本？

A: MySQL 8.0+ 或兼容数据库（如 MariaDB 10.6+）。需设置 characterEncoding=utf8mb4。

Q: Redis 版本有要求吗？

A: Redis 6.0+，推荐 7.0+。

Q: 可以用 Docker 部署吗？

A: 可以。参考 部署指南 中的 Docker Compose 方案。

Q: 默认账号密码是什么？

A: admin / 123456，首次登录后请立即修改密码。

使用操作

Q: 如何新增一个菜单？

A: 进入「系统管理 → 菜单管理」，点击「新增」，填写菜单名称、路由路径和组件路径，选择上级菜单后保存。

Q: 如何给角色分配权限？

A: 进入「系统管理 → 角色管理」，编辑角色，在「菜单权限」树中勾选对应菜单和按钮权限，保存即可。

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。