在 mapstruct 映射中，需使用 defaultexpression（而非 defaultvalue）为 instant 字段注入 instant.now()，否则会因字符串误解析导致 datetimeparseexception。
在 mapstruct 映射中，需使用 defaultexpression（而非 defaultvalue）为 instant 字段注入 instant.now()，否则会因字符串误解析导致 datetimeparseexception。
在使用 MapStruct 进行 DTO 与实体类转换时，常需为时间戳字段（如 createdAt、updatedAt）自动填充当前时间。对于 java.time.Instant 类型，关键在于区分 defaultValue 和 defaultExpression 的语义与生成逻辑：
- ✅ defaultExpression：将表达式原样嵌入生成的 Java 代码中，作为可执行代码调用（如 Instant.now()）；
- ❌ defaultValue：将值视为字符串字面量，并尝试通过类型对应的 parse() 方法（如 Instant.parse("...")）解析——这正是报错根源。
你遇到的异常：
java.time.format.DateTimeParseException: Text 'java(Instant.now())' could not be parsed
正是因为错误地使用了 defaultValue = "java(Instant.now())"，导致 MapStruct 生成了类似以下的无效代码：
post.setCreatedAt(Instant.parse("java(Instant.now())")); // 编译虽过，运行必抛异常✅ 正确写法如下（注意取消注释并移除 defaultValue）：
@Mapper(componentModel = "spring")
public interface CreatePostRequestMapper {
@Mapping(target = "createdAt", defaultExpression = "java(Instant.now())")
Post toEntity(CreatePostRequest source);
CreatePostRequest toDto(Post destination);
}? 无需 imports = {Instant.class}：Instant 是 JDK 标准类，MapStruct 能自动识别其全限定名；显式导入反而可能引发冗余或冲突。
生成的目标代码将为：
post.setCreatedAt(Instant.now()); // 直接调用静态方法，类型安全且高效
? 进阶建议：
- 若需统一处理多个时间字段（如 createdAt + updatedAt），可结合 @BeforeMapping 或自定义 @Named 方法提升复用性；
- 对于 LocalDateTime 等其他时间类型，同样适用 defaultExpression，但需确保表达式返回兼容类型（如 LocalDateTime.now()）；
- 始终通过编译后检查 target/generated-sources/annotations/ 下的 Mapper 实现类，验证生成逻辑是否符合预期。
总结：defaultExpression 是注入动态值（尤其是方法调用）的唯一可靠方式；defaultValue 仅适用于不可变的字符串、数字等字面量默认值（如 "N/A"、"0"）。理解这一设计差异，是写出健壮、可维护 MapStruct 映射逻辑的基础。
