MyBatis-Plus动态表名功能通过DynamicTableNameInnerInterceptor插件，在SQL执行前识别逻辑表名并调用TableNameHandler动态替换为物理表名，实现按时间或业务ID分表的无侵入支持。

在Atoms平台完成代码生成后，数据库表名、字段名与实体类不一致，或者需要切换数据源、启用逻辑删除等特性时，必须手动调整生成的数据库映射配置，否则运行时会抛出Invalid column name（无效列名）或Table 'xxx' doesn't exist（表'xxx'不存在）等异常。

确认映射配置所在位置

Atoms 生成的 Ja va 项目中，数据库映射配置默认集中在 src/main/resources/mapper/ 目录下，每个实体对应一个 XML 文件（如 UserMapper.xml），同时实体类（User.ja va）顶部通常带有 @TableName("sys_user") 注解。

先打开对应实体类，检查是否已存在 @TableName 或 @TableField 注解——如果不存在，说明 Atoms 未启用 MyBatis-Plus 映射增强，后续所有字段映射都必须靠 XML 中的 显式声明。

修正表名映射关系

方法一：通过注解修改（推荐用于 MyBatis-Plus 项目）

在实体类顶部添加或修改 @TableName 注解，值为数据库实际表名，例如：@TableName("t_customer_order")。这一步必须做，否则 MP 默认按类名转下划线规则匹配（CustomerOrder → customer_order），而真实表名可能是 t_customer_order 或 customerOrders。

方法二：通过 XML 的 namespace 绑定（适用于纯 MyBatis）

打开 UserMapper.xml，确认 中的 namespace 与接口全限定名完全一致；然后在 标签的 SQL 中，把 FROM user 显式改为 FROM sys_user ——XML 不会自动推导表名，漏改将直接查错表。

处理字段名不一致问题

第一步：识别不一致字段

对比数据库字段（如 create_time、is_deleted）和实体属性（如 createTime、deleted），记录所有大小写、下划线/驼峰差异项。

第二步：优先使用 @TableField 注解标注

在实体类对应属性上方添加 @TableField("create_time")，注意引号内必须是数据库**实际列名**，且区分大小写（尤其 PostgreSQL）。若字段参与 WHERE 条件但被忽略，查询将永远返回空结果。

第三步：XML 中同步更新

在UserMapper.xml的里，找到像这样的映射项，一定要保证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 条件（兼容旧项目）

在所有

和 标签的 SQL 末尾，追加 AND deleted = 0。这一步容易遗漏，建议用 IDE 全局搜索 后批量补全。