问题现象

在Spring Boot应用开发中，当使用@PathVariable或@RequestParam等注解时，控制台突然抛出异常：

Name for argument of type [java.lang.String] not specified

特别是在升级Spring版本或切换JDK后更容易出现。

根本原因

1.编译信息丢失：Java编译器默认不保留方法参数名（安全考虑）

2.注解使用不规范：未显式指定参数名（如@RequestParam(“name”)）

3.环境差异：

• JDK版本低于8u60

• 未启用-parameters编译选项

• Spring Boot版本低于2.2.x

四种解决方案

方案1：编译器配置（推荐）

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

优点：一劳永逸，适合新项目

方案2：显式命名参数

@GetMapping("/test")
public String test(@RequestParam("paramName") String name) {
    // ...
}

适用场景：快速修复已有代码

方案3：升级环境

• JDK升级到8u60+或11+

• Spring Boot升级到2.2+

方案4：接口默认方法（Java8+）

public interface MyService {
    default String process(@RequestParam String name) {
        // 实现...
    }
}

最佳实践

1.新项目务必配置-parameters

2.生产环境代码建议显式指定参数名

3.使用Lombok时注意@Builder等注解的影响

4.单元测试中模拟参数解析：

mockMvc.perform(get("/api")
    .param("name", "test"))

The end.