Java API接口的Content-Type传输规范核心是类型明确、编码一致、场景匹配：请求头告知后端数据格式（如application/json;charset=UTF-8），影响@RequestBody解析；响应头告知客户端数据类型（如application/vnd.openxmlformats-officedocument.spreadsheetml.sheet），决定渲染或下载行为，须配合Content-Disposition和X-Content-Type-Options等头字段协同使用。
Java API 接口的 Content-Type 传输规范，核心在于“类型明确 + 编码一致 + 场景匹配”。它不是单纯设个头字段，而是贯穿请求解析、数据处理、响应生成全过程的协同约定。尤其在涉及中文、文件、JSON 或表单时，错一个环节就可能引发乱码、400 错误或下载失败。
明确区分请求与响应的 Content-Type 职责
Content-Type 在请求和响应中作用不同，不能混用逻辑：
-
请求头（客户端发给服务端）：告诉后端“我传的是什么格式”，影响 Spring 等框架如何解析 body。比如 POST JSON 必须带
Content-Type: application/json;charset=UTF-8，否则@RequestBody可能绑定失败或解码乱码。 -
响应头（服务端返回给客户端）：告诉浏览器或调用方“你收到的是什么”，决定渲染方式。例如导出 Excel 时若返回
text/html，页面会直接显示二进制乱码；正确应设为application/vnd.openxmlformats-officedocument.spreadsheetml.sheet并配合Content-Disposition: attachment; filename="data.xlsx"。
文本类接口统一强制 UTF-8 编码
只要涉及文本（JSON、XML、HTML、纯文本），必须显式声明 charset=UTF-8，不依赖默认值：
- Spring Boot 默认使用 UTF-8，但需确认配置生效：
spring.http.encoding.charset=UTF-8和spring.http.encoding.force=true（旧版）或server.servlet.encoding.charset=UTF-8（2.3+）。 - 手动设置响应头时，避免只写
application/json，而要用application/json;charset=UTF-8；同理，text/plain、text/xml等也需补全 charset。 - 特别注意：不要用
text/xml处理含中文的 XML，改用application/xml——后者会尊重 XML 声明中的编码（如<?xml version="1.0" encoding="UTF-8"?>），前者会忽略。
按业务场景精准选用子类型
别让 application/octet-stream 成为万能兜底。不同数据类型对应不同语义，影响客户端行为：
立即学习“Java免费学习笔记（深入）”；
-
JSON 数据交互：始终用
application/json，前端 fetch/fetch 里headers: {'Content-Type': 'application/json'}，后端 Controller 方法加@RequestBody即可自动反序列化。 -
表单提交：普通键值对用
application/x-www-form-urlencoded；含文件则必须用multipart/form-data（且不可手动设 charset，边界由浏览器自动生成）。 -
文件下载：根据实际文件类型设 subtype，如 PDF →
application/pdf，PNG →image/png，Word →application/vnd.openxmlformats-officedocument.wordprocessingml.document。避免笼统用application/octet-stream，否则移动端可能无法识别打开方式。
配合其他头字段强化语义
Content-Type 很少单独起作用，常需搭配其他响应头协同工作：
- 下载类接口必加
Content-Disposition: attachment; filename="xxx.ext"，否则浏览器可能尝试渲染而非下载。 - 防止 MIME 嗅探攻击，响应头中加入
X-Content-Type-Options: nosniff，禁用浏览器“猜类型”行为，强制以 Content-Type 字面值为准。 - 对静态资源或 API 响应，合理设置
Cache-Control，避免因缓存导致旧 Content-Type 被复用（尤其在接口升级后修改了返回格式时）。
