需将atoms平台默认自增主键改为业务主键,通过字段属性或主键配置面板设置业务字段为主键并取消自增选项,再在代码生成模块选择“仅更新主键相关代码”,修改主键策略为应用层生成并指定ikeygenerator实现类。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Atoms平台完成代码生成后,需要将默认主键规则从自增ID改为业务主键(如订单号、用户编码等),且不能重新触发全量代码生成覆盖已有业务逻辑。
确认主键字段当前状态
进入Atoms项目 → 模型管理 → 找到目标实体 → 点击「编辑」→ 查看「字段列表」中主键字段的「主键类型」是否为「自增主键」、「数据库生成」或「无」。
若显示为「自增主键」,说明尚未手动指定业务主键字段;若已设为「业务主键」但值不正确,需继续修改规则而非重建字段。
将主键切换为业务主键字段
方法一:通过字段属性直接设置
在该实体的字段列表中,找到拟作为主键的业务字段(如orderNo、userCode),点击其右侧「编辑」图标 → 勾选「主键」复选框 → 取消勾选「自增」和「数据库生成」→ 保存字段。
【必须取消“自增”选项,否则生成的Mapper XML仍会保留useGeneratedKeys="true",导致插入时忽略传入值】
方法二:通过主键配置面板统一设置
点击实体右上角「主键配置」按钮 → 在弹出面板中清除原有主键字段 → 点击「添加主键字段」→ 从下拉列表选择业务字段 → 设置「生成方式」为「应用层赋值」→ 提交。
更新主键生成规则并同步到代码
第一步:进入「代码生成」模块 → 选择对应实体 → 点击「高级设置」
第二步:在「主键策略」区域,将「主键生成方式」由「数据库自增」改为「应用层生成」
第三步:展开「自定义主键生成器」,填写Java类全限定名(如com.example.idgen.OrderNoGenerator)→ 确保该类已在工程中存在且实现IKeyGenerator接口
第四步:勾选「仅更新主键相关代码」→ 点击「生成」→ 等待提示「生成完成,共更新3个文件」
这一步不会重写Service、Controller等已有逻辑,只刷新Entity的@TableId注解、Mapper XML中的keyProperty/keyColumn、以及XML插入语句中的











