Spring Boot中MapStruct自定义装饰器不生效问题求助

针对你遇到的装饰器逻辑未触发、imageBase64字段为空的问题，可按以下步骤排查解决：

1. 移除旧的手动Mapper注册配置 #

如果你之前写过手动注册Mapper Bean的@Configuration类，必须删除它。MapStruct通过componentModel = "spring"会自动生成带@Component注解的实现类，旧的手动注册会覆盖自动生成的代理Bean，导致装饰器逻辑被跳过。

2. 修改装饰器为构造注入 #

Spring Boot 3更推荐构造注入，字段注入可能存在代理Bean注入顺序的问题。调整装饰器代码：

public abstract class CategoryMapperDecorator implements CategoryMapper {
    protected final CategoryMapper delegate;

    // 用构造注入替代字段注入
    public CategoryMapperDecorator(CategoryMapper delegate) {
        this.delegate = delegate;
    }

    @Override
    public CategoryDTO mapToCategoryDTO(Category category) {
        // 先调用委托类完成基础映射
        CategoryDTO dto = delegate.mapToCategoryDTO(category);
        // 这里添加你的自定义装饰逻辑，比如填充imageBase64
        if (category.getImage() != null) {
            dto.setImageBase64(Base64.getEncoder().encodeToString(category.getImage()));
        }
        return dto;
    }
}

3. 验证Gradle依赖配置 #

确保build.gradle中正确引入MapStruct的编译和注解处理器依赖：

dependencies {
    // MapStruct核心依赖
    implementation 'org.mapstruct:mapstruct:1.5.5.Final'
    // MapStruct注解处理器，必须添加
    annotationProcessor 'org.mapstruct:mapstruct-processor:1.5.5.Final'

    // 如果用到Lombok，也要同步配置注解处理器
    implementation 'org.projectlombok:lombok'
    annotationProcessor 'org.projectlombok:lombok'
}

4. 确认组件扫描范围 #

确保CategoryMapper接口和CategoryMapperDecorator类所在的包，被Spring Boot的@ComponentScan覆盖（默认主启动类所在包及其子包都会被扫描）。如果不在扫描范围内，需调整扫描路径。

5. 检查生成的Mapper实现类 #

查看编译后生成的CategoryMapperImpl类（通常在build/classes/java/main下对应包路径），确认它正确继承了装饰器并注入了delegate：

@Component
public class CategoryMapperImpl extends CategoryMapperDecorator {
    private final CategoryMapper delegate;

    @Autowired
    public CategoryMapperImpl(@Qualifier("delegate") CategoryMapper delegate) {
        super(delegate);
        this.delegate = delegate;
    }

    // 其他方法的自动生成实现...
}

如果生成的类符合上述结构，说明MapStruct的配置是正确的，此时重启应用应该就能触发装饰器逻辑。

内容的提问来源于stack exchange，提问作者Norbert Maszlag