mybatis-plus动态表名功能通过dynamictablenameinnerinterceptor插件,在sql执行前识别逻辑表名并调用tablenamehandler动态替换为物理表名,实现按时间或业务id分表的无侵入支持。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在 Atoms 平台完成代码生成后,若数据库表名、字段名与实体类不一致,或需切换数据源、启用逻辑删除等特性,必须手动调整生成的数据库映射配置,否则运行时会抛出 Invalid column name 或 Table 'xxx' doesn't exist 等异常。
确认映射配置所在位置
Atoms 生成的 Java 项目中,数据库映射配置默认集中在 src/main/resources/mapper/ 目录下,每个实体对应一个 XML 文件(如 UserMapper.xml),同时实体类(User.java)顶部通常带有 @TableName("sys_user") 注解。
先打开对应实体类,检查是否已存在 @TableName 或 @TableField 注解——如果不存在,说明 Atoms 未启用 MyBatis-Plus 映射增强,后续所有字段映射都必须靠 XML 中的 <resultmap></resultmap> 显式声明。
修正表名映射关系
方法一:通过注解修改(推荐用于 MyBatis-Plus 项目)
在实体类顶部添加或修改 @TableName 注解,值为数据库实际表名,例如:@TableName("t_customer_order")。这一步必须做,否则 MP 默认按类名转下划线规则匹配(CustomerOrder → customer_order),而真实表名可能是 t_customer_order 或 customerOrders。
方法二:通过 XML 的 namespace 绑定(适用于纯 MyBatis)
打开 UserMapper.xml,确认 <mapper namespace="com.example.mapper.UserMapper"></mapper> 中的 namespace 与接口全限定名完全一致;然后在 <select></select> 标签的 SQL 中,把 FROM user 显式改为 FROM sys_user ——XML 不会自动推导表名,漏改将直接查错表。
处理字段名不一致问题
第一步:识别不一致字段
对比数据库字段(如 create_time、is_deleted)和实体属性(如 createTime、deleted),记录所有大小写、下划线/驼峰差异项。
第二步:优先使用 @TableField 注解标注
在实体类对应属性上方添加 @TableField("create_time"),注意引号内必须是数据库**实际列名**,且区分大小写(尤其 PostgreSQL)。若字段参与 WHERE 条件但被忽略,查询将永远返回空结果。
第三步:XML 中同步更新 <resultmap></resultmap>
在 UserMapper.xml 的 <resultmap id="BaseResultMap"></resultmap> 内,找到 <result property="createTime" column="create_time"></result> 这类映射项,确保 column 值与数据库列名完全一致。缺少这一行,即使加了注解,XML 查询仍会返回 null。
启用逻辑删除支持
方法1:配置全局逻辑删除策略(需 Spring Boot 配置文件)
在 application.yml 中添加:
mybatis-plus:
global-config:
db-config:
logic-delete-field: deleted
logic-delete-value: 1
logic-not-delete-value: 0
方法2:为实体字段显式声明逻辑删除
在实体类的 deleted 属性上添加 @TableLogic 注解,并确保该字段在数据库中为 TINYINT(1) 或 BIT 类型。【未添加 @TableLogic 注解时,MP 不会自动注入逻辑删除条件,DELETE 操作将变成物理删除】
方法3:XML 中手动追加 WHERE 条件(兼容旧项目)
在所有 <select></select> 和 <update></update> 标签的 SQL 末尾,追加 AND deleted = 0。这一步容易遗漏,建议用 IDE 全局搜索 <select> 后批量补全。</select>











