mapstruct引入不生效：解决mapstruct与lombok二者版本冲突问题

### MapStruct 失效的原因分析 当遇到 `@AfterMapping` 注解不生效的情况时，通常涉及多个潜在因素。以下是详细的失效原因及其对应的解决方案。 #### Lombok 和 MapStruct 的兼容性问题 如果项目中同时使用了 Lombok 和 MapStruct，则可能会出现两者之间的冲突。特别是当使用 Lombok 的 `@Builder` 注解时，可能导致 `@AfterMapping` 不生效[^1]。为了确保两者的正常协作，在某些情况下需要引入额外的依赖项来解决这一问题： 对于 Lombok 版本 1.18.16 或更高版本，需添加 `lombok-mapstruct-binding` 来保证二者能够协同工作[^4]。 ```xml <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok-mapstruct-binding</artifactId> <version>0.2.0</version> </dependency> ``` #### 编译问题 另一个常见的原因是编译过程中出现问题。这可能是由于 IDE 设置不当或 Maven/Gradle 构建配置错误引起的。建议清理并重新构建整个工程以确认是否存在此类问题[^3]。 #### 方法签名一致性 还需注意方法签名的一致性。确保自定义的方法名与默认生成的方法相匹配，并且参数列表也保持一致。如果不符，可能造成回调函数无法正确触发。 #### Getter 和 Setter 存在与否 源对象应具备相应的 getter 方法以便于取值操作；而目标对象则应当拥有 setter 方法用于设置属性值。若未提供这些访问器方法（例如忘记加上 Lombok 提供的 `@Data` 注解），同样会引发映射失败的问题[^5]。 ### 解决方案示例 针对上述提到的各种可能性，下面给出具体的修复措施： ##### 方案一：调整注解顺序 尝试改变 `@Mapper` 及其他相关注解的位置，使其位于类声明之前而不是接口内部。这样做有助于避免一些特定环境下可能出现的解析异常。 ##### 方案二：升级库版本 确保所使用的 MapStruct 和 Lombok 库均为最新稳定版。较新的发行版往往包含了更多改进和支持特性，能更好地适应现代 Java 开发环境的需求。 ```java // Example of proper setup with latest versions import org.mapstruct.Mapper; import lombok.Builder; @Mapper(componentModel = "spring") // Place this annotation at the class level instead inside interface public abstract class MyEntityMapper { @Mappings({ @Mapping(target = "targetField", source = "sourceField"), }) public abstract TargetClass toTarget(SourceClass source); @AfterMapping protected void afterMapping(@MappingTarget final TargetClass target, final SourceClass source) { // Custom logic here... } } ```