在 MapStruct 映射中，若需将目标对象的 Instant createdAt 字段自动设为当前时间，必须使用 defaultExpression 而非 defaultValue；后者会错误地尝试解析字符串字面量，导致 DateTimeParseException。
在 mapstruct 映射中，若需将目标对象的 `instant createdat` 字段自动设为当前时间，必须使用 `defaultexpression` 而非 `defaultvalue`；后者会错误地尝试解析字符串字面量，导致 `datetimeparseexception`。
MapStruct 提供了两种为未映射字段指定默认值的方式：defaultValue 和 defaultExpression，但二者语义与生成代码截然不同，尤其对不可序列化的类型（如 Instant、LocalDateTime、UUID 等）尤为关键。
- ✅ defaultExpression：执行 Java 表达式，直接插入到生成的映射方法体中，作为有效代码调用。
- ❌ defaultValue：提供字符串字面量值，MapStruct 会尝试通过 parse() 或构造器将其转换为目标类型——这对 Instant 意味着调用 Instant.parse("...")，而 "java(Instant.now())" 显然不是合法 ISO-8601 时间字符串。
因此，修正后的 Mapper 正确写法如下：
@Mapper(componentModel = "spring")
public interface CreatePostRequestMapper {
@Mapping(target = "createdAt", defaultExpression = "java(Instant.now())")
Post toEntity(CreatePostRequest source);
CreatePostRequest toDto(Post destination);
}? 注意事项：
- 不需要在 @Mapper 中显式 imports = {Instant.class} —— defaultExpression 中的 Instant.now() 会被原样保留，编译器能自动解析（前提是 Instant 已在作用域内，通常 java.time.Instant 已默认可访问）；
- 若 createdAt 是 null 且源对象未提供该字段，defaultExpression 将生效；若源对象明确传入 null，则需配合 nullValuePropertyMappingStrategy = NullValuePropertyMappingStrategy.IGNORE 避免覆盖；
- 对于更复杂的逻辑（如带时区的当前时间），可直接写表达式：defaultExpression = "java(Instant.now().atZone(ZoneId.of(\"Asia/Shanghai\")).toInstant())"。
最终生成的目标代码片段将类似：
post.setCreatedAt( Instant.now() ); // ✅ 正确：执行方法调用
而非错误的：
post.setCreatedAt( Instant.parse("java(Instant.now())") ); // ❌ 编译虽过，运行时报错✅ 总结：凡涉及动态计算、方法调用或非字符串字面量的默认值，一律使用 defaultExpression；仅当目标类型支持无参构造或标准字符串解析（如 String、int、枚举名）时，才考虑 defaultValue。这是 MapStruct 类型安全映射的关键实践之一。
