Spring Native镜像中Set反序列化失败问题求助

问题场景 #

运行Spring Native构建的镜像时，接口请求抛出反序列化异常，核心报错信息：

Cannot construct instance of java.util.HashSet (no Creators, like default constructor, exist): no default no-arguments constructor found
(through reference chain: com.example.app.payload.request.SignupRequest["roles"])

但以JAR包运行时完全正常，涉及代码如下：

SignupRequest类

public class SignupRequest {
    @NotBlank
    @Size(min = 3, max = 20)
    private String username;

    @NotBlank
    @Size(max = 50)
    @Email
    private String email;

    private Set<String> roles;

    @NotBlank
    @Size(min = 6, max = 40)
    private String password;

    // 手动编写getters & setters（项目已引入Lombok但未在此类使用）
}

控制器方法

public ResponseEntity<MessageResponse> registerUser(@Valid @RequestBody SignupRequest signUpRequest)

问题原因 #

Spring Native的AOT（提前编译）会做静态分析与优化，移除未被显式引用的类或构造器。Jackson在Native环境下无法通过反射动态创建HashSet实例——要么是AOT编译未保留HashSet的无参构造器，要么是无法识别Set<String>泛型对应的具体实现类。

解决方案 #

方案1：指定集合具体实现类 #

把roles字段类型从Set<String>改为HashSet<String>，让AOT编译明确要实例化的具体类：

private HashSet<String> roles;

方案2：添加Jackson反序列化注解 #

在roles字段上添加注解，指定反序列化时使用的具体实现类：

@JsonDeserialize(as = HashSet.class)
private Set<String> roles;

方案3：添加Spring Native反射提示 #

创建AOT提示配置类，告诉编译器保留HashSet的无参构造器：

import org.springframework.aot.hint.MemberCategory;
import org.springframework.aot.hint.RuntimeHints;
import org.springframework.aot.hint.RuntimeHintsRegistrar;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.ImportRuntimeHints;

@Configuration
@ImportRuntimeHints(HashSetRuntimeHints.class)
public class NativeConfig {

    static class HashSetRuntimeHints implements RuntimeHintsRegistrar {
        @Override
        public void registerHints(RuntimeHints hints, ClassLoader classLoader) {
            hints.reflection().registerType(HashSet.class, MemberCategory.INVOKE_DECLARED_CONSTRUCTORS);
        }
    }
}

方案4：适配Lombok与Spring Native（若项目使用） #

若项目依赖Lombok，在lombok.config文件中添加配置：

lombok.addLombokGeneratedAnnotation=true

让AOT编译能识别Lombok生成的代码，避免构造器或方法被误优化移除。

验证 #

修改后重新构建Spring Native镜像，测试接口请求，确认反序列化正常。

内容的提问来源于stack exchange，提问作者Garion S.