Swagger-ui.html 报错 java.lang.NumberFormatException 详细定位和解决思路

在日常开发中，使用 Swagger-ui 来管理和测试 API 接口时，我们有时会遇到一个棘手的报错信息：java.lang.NumberFormatException: For input string: ""。这个错误会阻止 Swagger-ui 正常加载，给开发人员带来困扰。

本文将深入分析这个报错的成因，并提供详细的定位和解决思路，帮助开发者快速解决问题，恢复 Swagger-ui 的正常使用。

报错原因定位

该报错通常出现在 Swagger-ui 解析用户请求时，从请求参数中提取数字类型的参数值时，发现该值为空字符串或无法转换为数字时。这可能是由于以下原因造成的：

• 用户在请求中未提供该参数。
• 请求参数的值不是有效的数字格式。
• Swagger-ui 的配置中存在问题，导致参数解析出现异常。

解决思路

根据报错原因，解决思路可以分为以下几个步骤：

1. 检查请求参数： 确保用户在请求中提供了正确的参数值，且该值符合预期的数字格式。
2. 核实 Swagger-ui 配置： 检查 Swagger-ui 的配置文件（如 swagger.yaml 或 swagger.json），确保参数解析的配置正确，并且与实际的 API 接口定义一致。
3. 调试代码： 如果前两步没有发现问题，则需要调试 Swagger-ui 的解析代码，定位具体出错的位置。这可以通过在代码中设置断点或使用日志打印信息来完成。

常见问题和解决方案

以下是解决该报错时经常遇到的常见问题及其解决方案：

• 参数值为空字符串： 修改 Swagger-ui 的配置，允许将空字符串转换为默认值或抛出错误。
• 参数值不符合数字格式： 检查 API 接口的定义，确保该参数的类型为数字类型，并提示用户输入有效的数字值。
• Swagger-ui 版本问题： 更新到 Swagger-ui 的最新版本，因为旧版本可能存在已修复的 bug。

总结

java.lang.NumberFormatException: For input string: "" 报错是 Swagger-ui 中常见的错误，通常由请求参数解析错误引起。通过遵循本文提供的定位和解决思路，开发者可以快速解决问题，恢复 Swagger-ui 的正常使用。在解决问题时，需要仔细检查请求参数、Swagger-ui 配置和代码，并根据具体情况采取相应的措施。