Springboot启动失败：解决「org.yaml.snakeyaml.error.YAMLException」报错全记录

## 关键字
Java、Springboot、vscode、idea、nacos启动失败、YAMLException、字符集配置

---

## 背景环境

### 项目架构
- **框架**：SSM（Spring + Spring MVC + MyBatis）
- **中间件**：Nacos（配置管理 + 服务发现）
- **配置存储**：Nacos中存储了Springboot的配置，包括：数据库连接信息、Redis连接信息、服务配置等。

### 问题场景
1. **开发工具切换**  
   - 原开发工具：IntelliJ IDEA  
   - 新开发工具：Visual Studio Code（VSCode）

2. **启动报错**  
   使用VSCode启动项目时，解析Nacos上的配置报错：
   ```bash
   org.yaml.snakeyaml.error.YAMLException: java.nio.charset.MalformedInputException: Input length = 1
   ```

---

## 原因分析

### 核心问题：字符集不匹配
1. **YAML文件编码问题**  
   - Nacos配置中心存储的YAML文件默认使用UTF-8编码。
   - VSCode默认启动配置未指定字符集，导致解析YAML文件时出现编码错误。

2. **开发工具差异**  
   - IntelliJ IDEA默认使用UTF-8编码，因此未出现此问题。
   - VSCode需要显式配置字符集，否则可能使用系统默认编码（如GBK）。

3. **错误表现**  
   - `MalformedInputException`表明输入流中存在无法解析的字符。
   - 通常是由于字符集不匹配导致的字节序列解析失败。

---

## 解决过程

### 试错路径记录

| 尝试方案              | 操作步骤                               | 结果状态      | 根本原因分析                    |
| ----------------- | ---------------------------------- | --------- | ------------------------- |
| **检查Nacos配置**   | 确认Nacos中的YAML文件编码为UTF-8         | 无变化      | 配置本身无问题，问题出在解析环节       |
| **修改VSCode设置**  | 全局设置VSCode文件编码为UTF-8             | 部分解决     | 仅影响编辑器，不影响运行时环境        |
| **调整启动配置**     | 修改`.vscode/launch.json`，添加字符集配置   | 成功解决     | 显式指定运行时字符集为UTF-8         |

---

## 最终解决

### 标准化解决方案
1. **修改VSCode启动配置**  
   在`.vscode/launch.json`中添加`encoding`字段，显式指定字符集为UTF-8：
   ```json
   {
       "configurations": [
           {
               "type": "java",
               "name": "xxx",
               "request": "launch",
               "cwd": "${workspaceFolder}",
               "mainClass": "xxx",
               "projectName": "xxx",
               "args": "",
               "envFile": "${workspaceFolder}/.env",
               "encoding": "UTF-8"
           }
       ]
   }
   ```

2. **关键点说明**  
   - `encoding`字段确保JVM运行时使用UTF-8字符集解析配置文件。
   - 此配置仅影响VSCode的启动行为，不影响其他开发工具。

3. **验证步骤**  
   - 重启VSCode。
   - 重新启动Springboot项目，确认YAML解析无报错。

---

## 总结

1. **字符集一致性**  
   - 确保开发工具、配置文件和运行时环境的字符集一致（推荐UTF-8）。

2. **工具差异处理**  
   - 切换开发工具时，注意工具默认配置的差异，必要时显式指定关键参数。

3. **调试技巧**  
   - 遇到编码问题时，优先检查文件编码和运行时字符集配置。