org.yaml.snakeyaml.error.YAMLException: java.nio.charset.MalformedInputException: Input length = 1异常问题解决
- 一、问题背景
- 二、错误现象
- 三、原因分析
- 核心问题：字符集不匹配
- 四、解决过程
- 试错路径记录
- 五、最终方案
- 1.创建launch.json文件，修改VSCode启动配置
- 2.在`.vscode/launch.json`中添加`encoding`字段，显式指定字符集为UTF-8：
- 3.验证步骤，确认YAML解析错误已解决
- 6.总结与反思
- 1.经验教训
- 2.扩展建议
#SpringBoot #VSCode #YAMLException #编码问题 #开发工具配置
一、问题背景
开发工具从IntelliJ IDEA切换到**Visual Studio Code（VSCode）**后，启动Springboot项目时出现YAML解析错误。该项目采用Nacos存储了Springboot的核心配置，包括数据库连接信息、Redis连接信息、服务配置等
二、错误现象
启动时报错信息：
org.yaml.snakeyaml.error.YAMLException: java.nio.charset.MalformedInputException: Input length = 1
关键错误点：MalformedInputException 表明输入流中存在无法解析的字符，通常由字符集不匹配导致。
三、原因分析
核心问题：字符集不匹配
- Nacos配置：配置中心存储的YAML文件默认使用UTF-8编码
- VSCode环境：默认未指定运行时字符集，可能使用系统默认编码（如GBK）
- 工具差异：IntelliJ IDEA默认使用UTF-8编码，因此未出现此问题
四、解决过程
试错路径记录
| 尝试方案 | 操作步骤 | 结果状态 | 根本原因分析 |
|---|---|---|---|
| 检查Nacos配置 | 确认Nacos中的YAML文件编码为UTF-8 | 无变化 | 配置本身无问题，问题出在解析环节 |
| 修改VSCode设置 | 全局设置VSCode文件编码为UTF-8 | 部分解决 | 仅影响编辑器，不影响运行时环境 |
| 调整启动配置 | 修改.vscode/launch.json，添加字符集配置 | 成功解决 | 显式指定运行时字符集为UTF-8 |
五、最终方案
1.创建launch.json文件，修改VSCode启动配置
2.在.vscode/launch.json中添加encoding字段，显式指定字符集为UTF-8：
{"configurations": [{"type": "java","name": "Springboot应用","request": "launch","cwd": "${workspaceFolder}","mainClass": "com.example.Application","projectName": "demo-project","args": "","envFile": "${workspaceFolder}/.env","encoding": "UTF-8" // 关键配置：指定运行时字符集}]
}
3.验证步骤，确认YAML解析错误已解决
- 保存修改后的
launch.json文件 - 重启VSCode
- 重新启动Springboot项目，确认YAML解析错误已解决
6.总结与反思
1.经验教训
- 字符集一致性：确保开发工具、配置文件和运行时环境的字符集保持一致（推荐统一使用UTF-8）
- 工具差异处理：切换开发工具时，需注意默认配置差异，必要时显式指定关键参数
- 调试技巧：遇到编码问题时，优先检查：
- 文件本身的编码格式
- 编辑器的显示编码设置
- 运行时环境的字符集配置
2.扩展建议
- 团队开发时，建议将
.vscode/launch.json纳入版本控制，统一开发环境配置 - 对于多环境部署，可在启动脚本中统一指定字符集参数：
-Dfile.encoding=UTF-8
