Spring Boot 处理配置文件特殊字符需区分格式：YAML 中用单/双引号包裹值防解析错误，Properties 中需转义=、:、空格等并推荐UTF-8编码；配置中心和运行时参数也须注意二次解析与编解码问题。
Spring Boot 中处理配置文件里特殊字符的核心，是分清配置格式（.properties 还是 .yml）以及字符出现的位置（配置值、配置键、或嵌入在 JSON/XML 等结构中）。不同格式解析规则差异大，不能一概而论。
YAML 文件中配置值含特殊字符
YAML 解析器（SnakeYAML）对冒号、感叹号、井号、星号等非常敏感。比如 spring.datasource.password=Admin!123 在 .properties 里没问题，但在 .yml 里会报错，因为 ! 被识别为 YAML 标签前缀。
- 用单引号包裹：最安全，所有内容按字面量处理，不解析转义序列
password: 'Admin!@#&' - 用双引号包裹：支持转义，如
"Hello\nWorld"中的\n会被换行password: "Admin!123"也可用，但仅限不含\或控制字符时 - 遇到以
:+ 空格开头的值（如description: ':value'），必须加引号，否则被误判为新 key - 多行文本优先用块标量：
|（保留换行）或>（折叠换行）
Properties 文件中配置值含特殊字符
.properties 默认使用 ISO-8859-1 编码，不支持中文和多数 Unicode 字符；特殊符号如 !、@、# 本身可直接写，但 =、:、空格、制表符需转义（用反斜杠 \ 前置）。
- 密码含空格：
password=pass\ word - 值以
#开头：name=\#admin（否则整行被当注释） - 推荐统一改用 UTF-8 编码：在
application.properties文件开头加注释# encoding=UTF-8，并确保编辑器保存为 UTF-8 - 中文或 emoji 建议用 Unicode 转义（如
\u4f60\u597d），或切换到.yml配合引号更直观
配置中心（如 Apollo/Nacos）里的特殊字符
配置中心通常将配置以文本形式下发，但客户端 SDK 在注入 Spring Environment 前会做一次解析。若配置项值含 !、${}、#{} 等，可能被二次解析或触发占位符替换。
- 在 Apollo 控制台填写时，对密码类字段直接用单引号包裹再提交（如
'P@ss!2026'） - 避免在配置值中使用
${xxx}，除非你明确需要 Spring 占位符解析；否则用$$转义，如url=jdbc:mysql://x.x.x.x:3306/db?useSSL=false&serverTimezone=GMT$$\{zone} - 检查客户端日志是否出现
Configuration parse failed类错误，重点排查冒号后紧跟空格、未闭合引号、或 YAML 缩进不一致
运行时参数或 HTTP 请求中的特殊字符
前端传参含 /、(、)、空格等，常因 URL 编码/解码不匹配导致后端接收异常。
- GET 请求路径参数含
/：Tomcat 默认拒绝%2F，需在启动类加系统参数System.setProperty("org.apache.catalina.connector.REJECT_UNSAFE_REQUESTS", "false"); - 接收带括号等字符的 query 参数：Spring 默认已做 URL 解码，但若中间有自定义 Filter（如 XSS 过滤器）做了重复转义，需关闭或调整顺序
- POST 提交 JSON 数据：确保前端设置
Content-Type: application/json，后端用@RequestBody接收，避免 String 类型参数被额外解码
