在 MapStruct 映射中，若需将目标对象的 Instant 字段自动设为当前时间（如 Instant.now()），必须使用 defaultExpression 而非 defaultValue，否则会因字符串误解析导致 DateTimeParseException。
在 mapstruct 映射中，若需将目标对象的 `instant` 字段自动设为当前时间（如 `instant.now()`），必须使用 `defaultexpression` 而非 `defaultvalue`，否则会因字符串误解析导致 `datetimeparseexception`。
在使用 MapStruct 进行 DTO 与实体类映射时，常需为审计字段（如 createdAt、updatedAt）自动填充当前时间戳。对于 java.time.Instant 类型，一个典型误区是误用 defaultValue 属性：
@Mapper(componentModel = "spring")
public interface CreatePostRequestMapper {
// ❌ 错误：defaultValue 将值作为字符串字面量处理
@Mapping(target = "createdAt", defaultValue = "java(Instant.now())")
Post toEntity(CreatePostRequest source);
}该写法会导致 MapStruct 生成类似以下代码：
post.setCreatedAt(Instant.parse("java(Instant.now())")); // 编译通过，运行时报错！由于 Instant.parse() 尝试解析字符串 "java(Instant.now())"，而非执行 Java 表达式，因此抛出 DateTimeParseException。
✅ 正确做法是使用 defaultExpression，它明确告知 MapStruct：这是一个需在生成代码中直接嵌入并执行的 Java 表达式：
@Mapper(componentModel = "spring", imports = {Instant.class})
public interface CreatePostRequestMapper {
@Mapping(target = "createdAt", defaultExpression = "java(Instant.now())")
Post toEntity(CreatePostRequest source);
CreatePostRequest toDto(Post destination);
}✅ 注意事项：
- defaultExpression 的值必须是合法、可编译的 Java 表达式（含分号非必需，MapStruct 会自动处理）；
- 若表达式涉及静态方法或类型，需通过 imports 显式声明（如 imports = {Instant.class}），否则生成代码可能缺少 import 语句；
- defaultExpression 仅在源对象中对应字段为 null 时生效；若需无条件覆盖（例如强制刷新时间戳），应改用 @AfterMapping 或自定义映射方法；
- 对于 LocalDateTime、ZonedDateTime 等其他时间类型，同理应使用 defaultExpression + 对应工厂方法（如 LocalDateTime.now()）。
补充示例：若需带时区的当前时间，可写为：
@Mapping(target = "updatedAt",
defaultExpression = "java(java.time.ZonedDateTime.now(java.time.ZoneId.of(\"UTC\")))")总之，defaultValue 用于提供字符串字面量默认值（适用于 String、基本类型包装类等），而 defaultExpression 才是注入动态 Java 逻辑的正确入口——尤其对 Instant 这类不可直接由字符串构造的时间类型，二者绝不可混淆。
