应手动修改 src/main/java 下的 mapstruct 映射接口而非 generated-sources 中文件；跳过字段用 @mapping(ignore=true) 或 @beanmapping(ignorebydefault=true)；字段名不一致时用 @mapping(source="xxx", target="yyy") 显式映射；类型不兼容可借助工具类、表达式或 default 方法处理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你用 Atoms（或类似低代码平台）生成了初始 DTO 代码，但发现字段名不匹配、类型需转换、或需跳过某些字段时，必须手动介入修改映射逻辑——这不是覆盖重生成，而是精准修补已生成的 MapStruct 映射器。
确认 Atoms 生成的映射器是否为 MapStruct 风格
打开项目中由 Atoms 生成的 mapper 接口文件（通常位于 src/main/java/xxx/mapper/ 下），检查是否含 @Mapper 注解且无 implements 或 new 实例化语句。若看到 public interface UserDtoMapper { ... } 且顶部有 @Mapper(componentModel = "spring")，说明它是标准 MapStruct 接口，可安全二次编辑。
【不可直接修改 generated-sources 目录下的 .java 文件】 Atoms 可能将真实实现类输出到 target/generated-sources/annotations/，该目录内容每次 clean 编译都会被清空。所有人工修改必须落在你手写的 mapper 接口（即 src/main/java 下的接口）中。
跳过某个 DTO 字段不映射
方法一：用 @Mapping 注解忽略字段
在 mapper 接口的方法声明上方添加 @Mapping(target = "password", ignore = true)，其中 target 值必须与 DTO 中字段名完全一致（区分大小写），ignore = true 表示该字段不参与自动赋值。
方法二：用 @BeanMapping 批量忽略
若多个字段都要跳过（如 createBy、updateTime、version），在方法上加 @BeanMapping(ignoreByDefault = true)，再对需要映射的字段显式声明 @Mapping，例如：@Mapping(target = "id", source = "userId")。这样可彻底反转默认行为，避免漏忽略。
修正字段名不一致的映射
第一步：定位源对象与 DTO 中不一致的字段对
比如 PO 中是 user_name（下划线），DTO 中是 userName（驼峰），MapStruct 默认不会自动转换，必须显式声明。
第二步：在 @Mapping 中用 source 指定原始字段名
写法：@Mapping(target = "userName", source = "user_name")。注意 source 值必须是源对象（如 User 实体）中 getter 方法去掉 get 后的名称，即 getUserName() → userName，getUserName() 不存在时才填 user_name（前提是该字段为 public 或有对应 getter）。
第三步：验证编译是否通过
执行 mvn compile。若报错 Unmapped target property: 'xxx'，说明还有字段没覆盖；若报错 Can't map property "xxx" to "yyy"，说明 source 写错了 getter 名或字段不存在。
处理字段类型不兼容（如 String ↔ LocalDateTime）
方法1：使用内置日期格式转换
添加 @Mapper(uses = {LocalDateTimeMapper.class}) 到接口顶部，然后新建 LocalDateTimeMapper 工具类，含两个静态方法：stringToLocalDateTime(String) 和 localDateTimeToString(LocalDateTime)。MapStruct 会自动识别并调用它们。
方法2：内联表达式（适合简单转换）
写法：@Mapping(target = "createTime", expression = "java(java.time.LocalDateTime.parse(source.getCreateTimeStr(), java.time.format.DateTimeFormatter.ofPattern(\"yyyy-MM-dd HH:mm:ss\")))")。注意双引号需转义，且 source 指代输入参数对象，不是字符串字面量。
方法3：自定义映射方法（推荐用于复用场景）
在同一个 mapper 接口中，添加一个 default 方法：default String formatStatus(Integer status) { return status == 1 ? "ACTIVE" : "INACTIVE"; }，然后在 @Mapping 中写 @Mapping(target = "statusDesc", source = "status") 即可触发该方法——MapStruct 会自动匹配参数类型和返回类型。
