spring boot rest接口特殊字符处理需分层协同：浏览器编码→容器解码→spring路径匹配→参数绑定→响应渲染，关键在于各层编码策略一致，而非简单加utf-8。
Spring Boot 处理 REST 接口中的特殊字符（如中文、空格、斜杠、括号等）本质上是分层协同的结果：浏览器编码 → 容器解码 → Spring 路径匹配 → 参数绑定 → 响应渲染。乱码或转义异常不是某一个环节出错，而是各层编码策略不一致导致的。关键不在“怎么加 UTF-8”，而在于明确每层谁负责解码、何时解码、是否重复解码。
URL 路径中中文和特殊字符（如 /、+、%）的处理
@PathVariable 默认会拿到 Tomcat 已解码后的路径片段。例如请求 /user/张三 或 /user/%E5%BC%A0%E4%B8%89，只要 Tomcat 的 URIEncoding=UTF-8 生效，最终进 Controller 的就是“张三”这个字符串。
但以下情况会翻车：
- 路径中含未编码的斜杠
/（如/file/path/to/name.txt），会被 Tomcat 当作多级路径截断，导致 404；必须前端先用encodeURIComponent()编码成/file%2Fpath%2Fto%2Fname.txt，后端再用@PathVariable String path接收，Spring 会自动还原为原始路径字符串 - 路径中含空格，浏览器通常自动转为
+或%20；Tomcat 对+默认按空格解码（符合传统表单规则），但对%20才严格按 URL 编码规则解码；建议统一用%20，避免歧义 - 若需接收原始编码字符串（比如要校验签名或透传原始路径），可关闭 Tomcat 自动解码：在
application.yml中设server.tomcat.uri-encoding=ISO-8859-1，然后在 Controller 中手动调用URLDecoder.decode(path, "UTF-8")
查询参数（@RequestParam）里的中文与空格
GET 请求的 query 参数（如 ?name=张三&desc=hello world）默认由 Tomcat 按 URIEncoding 解码，但注意：Tomcat 7+ 默认对 query string 使用 ISO-8859-1 解码（即使 URIEncoding 设为 UTF-8，也仅影响路径部分）。所以必须显式配置：
application.yml
server:
tomcat:
uri-encoding: UTF-8
spring:
web:
resources:
add-mappings: false
更稳妥的做法是：在 WebMvcConfigurer 中注册自定义 CharacterEncodingFilter 并设 force=true，确保所有请求参数都强制按 UTF-8 解析。
POST/PUT 请求体中 JSON 或表单数据的中文处理
这类数据走的是请求体（body），不受 URI 解码影响，但依赖：
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 请求头是否声明
Content-Type: application/json;charset=UTF-8（JSON）或application/x-www-form-urlencoded;charset=UTF-8（表单） - Spring 的
HttpMessageConverter是否使用 UTF-8 解析：Jackson 默认支持 UTF-8，但需确认没有被覆盖；可在配置类中显式设置：
Java 配置示例
@Configuration
public class WebConfig implements WebMvcConfigurer {
@Override
public void configureMessageConverters(List<httpmessageconverter>> converters) {
// 确保 Jackson 使用 UTF-8
MappingJackson2HttpMessageConverter jackson = new MappingJackson2HttpMessageConverter();
jackson.setDefaultCharset(StandardCharsets.UTF_8);
converters.add(0, jackson); // 插入最前，优先级最高
}
}</httpmessageconverter>
空格在 JSON 字符串中无需额外转义（"name": "hello world" 合法），但若前端用 FormData 提交，空格会被浏览器自动编码为 +，后端需确保表单解析器也按 UTF-8 处理。
响应内容与文件下载中的文件名编码
接口返回 JSON 中的中文只要响应头带 Content-Type: application/json;charset=UTF-8 就不会乱码。Spring Boot 2.3+ 默认已满足，但建议在全局配置中加固：
application.yml
spring:
http:
encoding:
charset: UTF-8
enabled: true
force: true
server:
servlet:
encoding:
charset: UTF-8
enabled: true
force: true
文件下载时，Content-Disposition 中的中文文件名必须用 filename* 格式，例如：
Content-Disposition: attachment; filename="report.pdf"; filename*=UTF-8''%E4%B8%AD%E6%96%87%E6%8A%A5%E5%91%8A.pdf
Java 中可这样构造：
String fileName = "中文报告.pdf";
String encodedName = URLEncoder.encode(fileName, "UTF-8").replace("+", "%20");
response.setHeader("Content-Disposition",
"attachment; filename=\"" + fileName + "\"; filename*=UTF-8''" + encodedName);
