低代码常见问题

发布失败

数据库表创建失败

现象：发布时报错 "Table already exists" 或 "Unknown column"。

排查：

1. 检查数据库中是否已存在同名的表
2. 检查字段名是否包含数据库保留字（如 order、group）
3. 查看后端日志 forge-server/forge-admin-server/logs/ 获取详细错误

解决：修改业务对象的表名或字段名后重新发布。

检查不通过

现象：发布按钮灰色或提示检查失败。

排查：

1. 确认业务对象至少配置了一个字段
2. 确认表单设计中至少拖入一个字段
3. 确认列表设计中至少选择一个显示列

数据不显示

列表页空白

现象：列表页打开后无数据，但数据库中有记录。

排查：

1. 检查当前用户的角色是否分配了该页面的查看权限
2. 检查数据权限范围是否限制为"仅本人"
3. 检查 tenant_id 是否与当前租户一致
4. 检查 del_flag 是否为 0（逻辑删除标记）

新增数据后列表不刷新

现象：新增成功但列表未显示新记录。

解决：检查列表设计器是否配置了「刷新列表」动作，或手动刷新页面。

关联对象为空

现象：列表中关联字段列显示空白。

排查：

1. 确认关联对象已发布
2. 确认关联字段的显示字段配置正确
3. 检查关联记录的 del_flag 是否为 0
4. 检查关联记录的数据权限是否可见

权限不足

菜单不显示

现象：发布成功但左侧菜单看不到入口。

解决：

1. 进入「菜单管理」确认菜单已生成
2. 进入「角色管理」→「菜单授权」，为当前角色勾选该菜单
3. 刷新浏览器页面

按钮不显示

现象：列表页缺少新增、编辑等操作按钮。

解决：在角色管理中为当前角色分配对应的按钮权限（add、edit、delete）。

表单提交失败

现象：填写表单后点击保存报错。

排查：

1. 检查必填字段是否已填写
2. 检查字段格式校验是否通过（手机号、邮箱等）
3. 查看后端日志确认是否有数据库约束异常
4. 检查字段长度是否超出数据库列定义

字段类型不匹配

现象：下拉框选项为空或显示异常。

解决：

1. 确认下拉字段绑定的字典类型是否存在
2. 在「字典管理」中检查字典数据是否已配置
3. 确认字典数据的 dict_value 与存储值一致