Spring Boot原生镜像转换中MongoDB仓库参数缺失致MappingException

问题描述 #

使用Spring Native和GraalVM将Spring Boot应用转为原生镜像后，通过MongoDB仓库层交互时抛出MappingException，报错信息：

Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed: org.springframework.data.mapping.MappingException: Parameter org.springframework.data.mapping.Parameter@bf07bd2a does not have a name] with root cause

已尝试的方案：

• 在RuntimeHintsRegistrar实现中注册文档类和仓库，无效。
• 使用GraalVM原生镜像代理生成反射配置，问题依旧。

解决方案 #

1. 强制编译保留构造函数参数名 #

GraalVM原生编译默认会丢弃Java类构造函数的参数名称，而Spring Data MongoDB依赖参数名完成字段映射。需在编译阶段添加参数保留配置：

• Maven：在pom.xml的maven-compiler-plugin中添加配置：

  <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <configuration>
          <compilerArgs>
              <arg>-parameters</arg>
          </compilerArgs>
      </configuration>
  </plugin>
  

• Gradle：在build.gradle中添加：

  tasks.withType(JavaCompile) {
      options.compilerArgs << '-parameters'
  }
  

2. 显式绑定构造函数参数与Mongo字段 #

若上述配置无效，直接在实体类构造函数参数上用@Field注解指定对应Mongo字段：

public class User {
    private String id;
    private String username;

    public User(@Field("username") String username) {
        this.username = username;
    }
    // getter/setter
}

3. 补充RuntimeHints的反射配置 #

除注册文档类和仓库，需显式注册实体类构造函数的反射权限：

public class MongoRuntimeHints implements RuntimeHintsRegistrar {
    @Override
    public void registerHints(RuntimeHints hints, ClassLoader classLoader) {
        // 注册实体类及其构造函数、字段的反射权限
        hints.reflection().registerType(User.class,
            hint -> hint.withConstructor(String.class)
                        .withField("id")
                        .withField("username"));
        // 注册Mongo仓库接口的代理类
        hints.proxies().registerJdkProxy(MongoRepository.class);
    }
}

然后在启动类上添加@ImportRuntimeHints(MongoRuntimeHints.class)启用配置。

4. 校验版本兼容性 #

确保Spring Native与GraalVM版本匹配，例如Spring Native 0.12.x对应GraalVM 22.3+，版本不兼容可能导致反射配置失效。

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