Spring Boot从3.1.x升级到3.2.x后单元测试UUID参数报错

问题描述 #

将Spring Boot版本从3.1.3升级至3.2.3后，所有使用UUID作为参数的参数化单元测试均失败，抛出如下异常：

java.lang.IllegalArgumentException: Name for argument of type [java.util.UUID] not specified, and parameter name information not available via reflection. Ensure that the compiler uses the '-parameters' flag.

测试代码示例：

@ParameterizedTest(name = "Entity id: {0}")
@MethodSource("retrieveIds")
void shouldRetrieveSingleIfExist(UUID id) {
    client.get()
            .uri("/entities/{id}", id)
            .exchange()
            .expectStatus().isOk()
            .expectBody()
            .jsonPath("$.id").isEqualTo(id.toString());
}

已尝试无效操作：

• 参考相关技术问答无解决
• 在spring-boot-maven-plugin中添加<compilerArguments>-parameters</compilerArguments>无效果
• 回退至3.1.3版本测试全部正常通过

解决方案 #

1. 单独配置maven-compiler-plugin启用参数名编译 #

Spring Boot Maven插件的编译配置可能未覆盖测试代码的编译规则，直接配置maven-compiler-plugin显式启用参数名保留，确保主代码和测试代码编译时都能通过反射获取参数名：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.11.0</version>
            <configuration>
                <parameters>true</parameters> <!-- 核心配置，替代compilerArguments -->
                <source>17</source> <!-- 替换为项目实际使用的JDK版本 -->
                <target>17</target>
            </configuration>
        </plugin>
    </plugins>
</build>

2. 确保JUnit Jupiter版本与Spring Boot 3.2兼容 #

Spring Boot 3.2默认依赖JUnit Jupiter 5.10.x，若手动指定了JUnit版本可能引发兼容性问题。移除自定义的JUnit依赖，使用Spring Boot Starter Test自动管理版本：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-test</artifactId>
    <scope>test</scope>
</dependency>

3. 显式指定测试参数名（兜底方案） #

若编译配置仍不生效，可通过@Parameter注解给测试方法参数显式命名（需确保JUnit Jupiter版本支持该注解）：

import org.junit.jupiter.params.Parameter;

@ParameterizedTest(name = "Entity id: {0}")
@MethodSource("retrieveIds")
void shouldRetrieveSingleIfExist(@Parameter("id") UUID id) {
    // 测试代码逻辑不变
}

4. 清理Maven缓存并重新编译 #

配置修改后，执行以下命令清理缓存并重新编译项目，确保新配置生效：

mvn clean install -DskipTests

内容的提问来源于stack exchange，提问作者Adam Bogdan Boczek