常见问题
快速搭建相关
提示编码已存在
模型编码对应表名。如果模型已存在，可以在快速搭建页面绑定模型。
提示引导程序已存在
引导程序只是工具，不影响开发，更换一个编码即可。
页面设计新增页面时提示模型已存在
模型编码对应表名，如果模型已存在，可以在快速搭建页面绑定模型。
数据源相关
删除已存在数据源中的接口信息，页面接口异常报错
数据源中的接口信息删除后，接口生成的接口变量、接口函数都会被删除，需要重新绑定数据。
页面设计相关
组件画布页和预览页效果不同
平台页面设计中组件有两种状态：编辑态和预览态。组件的最终实现效果以预览画面为准，不以画布中为准。
如何设计滚动条
样式配置中设置 overflow-auto 样式。
数据权限相关
数据权限配置未生效
- 查看当前数据权限实例是否启用
- 查看当前数据权限实例是否授权给对应登录人或其所属角色
前置条件
下游系统的用户/部门/公司数据（HRMS 服务）需要同平台的 HRMS 服务建表及后台接口保持一致。角色服务、管理员角色类型建表数据等也需和平台保持一致。
角色、用户、部门拦截的前提：Nacos 开关和白名单固定配置。
系统设置相关
新增子系统后子系统不可见
- 确认登录的角色是否有配置菜单可见（系统管理 → 权限设置 → 角色管理）
- 确认当前创建的子系统下是否有子级菜单——没有子级菜单系统不展示空系统菜单
接口相关
接口收集未成功
- 该服务未在 Nacos 上注册成功 → 查看 Nacos 服务状况
- 字典中未配置该服务 → 系统字典 → 服务信息 → 服务列表中添加
- 配置的服务路径需与网关中一致，注意父子关系
- 本地开发使用「无感收集」，服务器使用「收集」
- 本地开发完成后重启服务确保接口生效
- 「无感收集」后查看控制台打印是否成功
- 使用路径查询接口，不要使用服务名查询
流程引擎相关
本地开发事件回调接口如何调试
场景一：服务器可访问本地服务
无需任何配置，直接调试。
场景二：服务器不可访问本地服务
- 下载 flow 服务 jar 包到
D:\project\JH4J-CODE - 启动：
java -jar -DNACOS_HOST={nacosId} -DAPP_NAME=JH4J-CODE-flow-{工号} -DNACOS_DISCOVERY_NAMESPACE=u - 配置网关转发规则（编辑
gateway.yml） - 修改接口服务为
JH4J-CODE-hrms-{工号}
注意
调试完后必须修改回主服务，否则影响线上运行。