33、java.lang.NumberFormatException-For input string-“”

复现空字符串、非法数字和溢出的解析边界,将通用输入处理与旧 Springfox 依赖问题分开。

简明结论

先识别数字解析输入与异常来源,不能把旧 Swagger 依赖覆盖当作通用 NumberFormatException 修复。

NumberFormatException 表示输入不符合目标数字解析规则,空字符串只是其中一种情况。先看完整调用栈:自己的参数转换与旧 Swagger 库解析模型默认值,处理位置可能完全不同,不能一律通过覆盖依赖版本解决。

先复现输入边界

下例把空白、缺失、非法字符与超出 int 范围统一表达为 OptionalInt.empty;这是这个示例选择的业务策略,不是 Java API 自动行为。需要把错误返回客户端时,可以进一步区分原因,不能把空值直接当作数字零。

import java.util.OptionalInt;

public class NumberParsing {
  static OptionalInt parse(String input) {
    if (input == null || input.isBlank()) return OptionalInt.empty();
    try { return OptionalInt.of(Integer.parseInt(input.trim())); }
    catch (NumberFormatException invalidOrOverflow) { return OptionalInt.empty(); }
  }
  public static void main(String[] args) {
    for (String invalid : new String[] { null, "", " ", "abc", "2147483648" }) {
      if (parse(invalid).isPresent()) throw new AssertionError("Unexpected parsed value");
    }
    if (parse(" 42 ").orElseThrow() != 42) throw new AssertionError();
    try { Integer.parseInt(""); throw new AssertionError("Expected rejection"); }
    catch (NumberFormatException expected) { /* input is not an integer */ }
    System.out.println("empty-rejected=true; invalid-or-overflow=empty; trimmed=42");
  }
}
javac NumberParsing.java
java NumberParsing

本次输出 empty-rejected=true; invalid-or-overflow=empty; trimmed=42。parseInt 本身不会自动 trim 输入,示例显式处理了前后空格;其他格式如小数、千分位与地区化数字需要单独规则。

旧 Swagger 问题如何继续调查

记录触发接口、模型字段与依赖树,再核对异常究竟来自应用代码还是文档生成库。下面保留原 Springfox 2.9.2 依赖覆盖片段,只作为历史排查线索。本轮没有运行该版本的 Swagger,也没有验证覆盖版本能解决当前工程问题。

下一步阅读

历史范例(未重建原环境)

以下保留旧资料的示例与输出,并校正语言标记和已发现的概念错误。含 MariaDB、旧 PHP/PDO、旧 Redis 或旧 JDK 语境的片段,本轮没有逐一运行;新实验的验证结论只适用于上方完整源码。不要把历史截图中的结果当作本轮输出。

很多朋友在升级Springfox-Swagger到2.9.2版本后会碰见NumberFormatException异常java.lang.NumberFormatException: For input string: “”

异常信息如下:

java.lang.NumberFormatException: For input string: ""
    at java.lang.NumberFormatException.forInputString(NumberFormatException.java:65) ~[na:1.8.0_111]
    at java.lang.Long.parseLong(Long.java:601) ~[na:1.8.0_111]
    at java.lang.Long.valueOf(Long.java:803) ~[na:1.8.0_111]
    at  
    //more....

原资料针对 Springfox 2.9.2 记录了排除 swagger-models 并覆盖为 1.5.21 的做法,如下。此历史兼容方案本轮未复测,也不适用于所有 NumberFormatException;修改依赖前应核对完整调用栈和依赖树。

<!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger2 -->
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.9.2</version>
    <exclusions>
        <exclusion>
            <groupId>io.swagger</groupId>
            <artifactId>swagger-models</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<!-- https://mvnrepository.com/artifact/io.swagger/swagger-models -->
<dependency>
    <groupId>io.swagger</groupId>
    <artifactId>swagger-models</artifactId>
    <version>1.5.21</version>
</dependency>