mapstruct失效

### MapStruct 失效的原因分析

当遇到 `@AfterMapping` 注解不生效的情况时，通常涉及多个潜在因素。以下是详细的失效原因及其对应的解决方案。

#### Lombok 和 MapStruct 的兼容性问题
如果项目中同时使用了 Lombok 和 MapStruct，则可能会出现两者之间的冲突。特别是当使用 Lombok 的 `@Builder` 注解时，可能导致 `@AfterMapping` 不生效[^1]。为了确保两者的正常协作，在某些情况下需要引入额外的依赖项来解决这一问题：

对于 Lombok 版本 1.18.16 或更高版本，需添加 `lombok-mapstruct-binding` 来保证二者能够协同工作[^4]。

<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 开发环境的需求。

// 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...
    }
}