Java检查可选@RequestParam是否为空时出现空类型安全警告

问题原因 #

你碰到的警告是因为Strings.isNullOrEmpty的参数被标记为@Nonnull，但你的ignoreRequest是允许为null的（required = false）。静态代码检测工具（比如IDEA的代码检查）会严格遵循注解规则，认为你把一个可能为空的变量传给了要求非空的参数——哪怕这个方法本身逻辑就是用来处理null的，还是会触发警告。

解决办法 #

1. 给参数标记@Nullable

在ignoreRequest上加上@Nullable注解，明确告诉检测工具这个参数允许为null，直接消除警告：

@PostMapping()
public ResponseEntity<String> postUser(
    UserCreationDTO userData,
    @RequestParam(required = false) @Nullable String ignoreRequest
) {
    try{
        if (!Strings.isNullOrEmpty(ignoreRequest)) {
            return new ResponseEntity<>(ignoreRequest, HttpStatus.OK);
        }
        return userService.createUser(userData);
    }catch (Exception exception) {
        exception.printStackTrace();
    }

    return BackendUtils.getResponseEntity(
        BackendConstants.SOMETHING_WRONG,
        HttpStatus.INTERNAL_SERVER_ERROR
    );
}

注意：@Nullable需要引入对应包，比如javax.annotation.Nullable或者org.jetbrains.annotations.Nullable，根据项目依赖选择即可。

2. 拆分判断逻辑

绕过Strings.isNullOrEmpty，手动拆分null和空字符串的判断逻辑，避开注解检查：

if (ignoreRequest != null && !ignoreRequest.isEmpty()) {
    return new ResponseEntity<>(ignoreRequest, HttpStatus.OK);
}

3. 调整IDE检查规则（不推荐）

如果不想修改代码，可以在IDE的Inspection设置里，找到「Nullability problems」下的「Unchecked conversion for nullable to non-null」，将检查级别调低或者禁用。但这种方法会削弱代码的空安全检测能力，不建议长期使用。

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