PHP API返回JSON但Content-Type为text/html，主因是Nginx未透传PHP头或提前输出导致header失效；需检查Nginx配置中fastcgi_pass_request_headers、mime.types加载及PHP文件BOM/错误输出。
PHP API 返回 JSON 但 Content-Type 是 text/html？
这是最常见误判：你以为后端没设 header，其实是 Nginx 拦截并“降级”了响应类型。phpEnv 默认用 fastcgi_pass 转发 PHP 请求，但若 location 块未显式指定 default_type 或未透传上游 header，Nginx 会 fallback 到 default_type application/octet-stream 或更糟——text/html（尤其当 PHP 输出含 HTML 标签或错误页时）。
关键点：Content-Type 最终由 Nginx 决定，不是 PHP 的 header() 单方面能保证的。
- 检查你的 phpEnv 的
nginx.conf或站点 conf 中是否启用了include mime.types;—— 若注释掉，所有静态/动态响应都可能变成text/html - 确认 location ~ \.php$ 块里没有覆盖性配置，比如
add_header Content-Type "text/html";这类硬编码 - 用
curl -I http://localhost/api/test.php直接看响应头，排除浏览器缓存干扰
为什么加了 header('Content-Type: application/json; charset=utf-8') 还是无效？
因为输出已提前触发。phpEnv 环境下常见三类“静默破坏”：
- PHP 文件开头有 BOM（尤其是 UTF-8 with BOM 编码的 .php 文件），导致
header()调用失败 -
error_reporting(E_ALL);或未捕获的 Notice 级错误（如 undefined index）在header()前输出了警告文本 - phpEnv 自带的某些全局
output_buffering配置被禁用，而代码中又没手动ob_start()，导致 echo/json_encode 提前冲刷缓冲区
验证方式：在 header() 前加一行 if (headers_sent($file, $line)) { die("Header already sent in $file on line $line"); }，立刻定位源头。
立即学习“PHP免费学习笔记（深入）”；
Nginx fastcgi_pass 场景下如何确保 Content-Type 透传？
phpEnv 默认用 FastCGI，Nginx 不解析 PHP 响应体，但会重写/丢弃部分 header。必须显式要求它尊重上游返回：
- 在
location ~ \.php$块中，**必须包含**：fastcgi_pass_request_headers on; - 禁用可能导致覆盖的指令：
fastcgi_hide_header Content-Type;（如果存在，删掉） - 不要用
add_header Content-Type ...硬编码——这会覆盖 PHP 返回的真实值；如需兜底，改用fastcgi_param HTTP_CONTENT_TYPE $http_content_type;（仅限调试） - 检查
fastcgi_intercept_errors off;—— 若为on，Nginx 可能把 PHP 的 500 错误页当正常响应，返回text/html
JSON 接口被当成下载文件（application/octet-stream）？
这通常发生在 Nginx 把 PHP 响应识别为“未知类型”，于是 fallback 到默认类型。根本原因常是：mime.types 未加载，或 default_type 被设为 application/octet-stream。
- 打开 nginx 主配置（通常是
/usr/local/phpenv/nginx/conf/nginx.conf），确认http块第一行是include mime.types;，且未被注释 - 检查是否有全局
default_type application/octet-stream;—— 如果有，把它改成default_type text/plain;或直接删掉（让 mime.types 主导） - 若你用
return 200+ 内联 JSON（如测试用），必须配default_type application/json;，否则 Nginx 不知道该用什么类型
真正难排查的是：Nginx 日志里看不到 Content-Type 错误，它只是安静地选错了类型。每次改完配置，务必用 nginx -t && nginx -s reload，别只改 PHP 代码就刷新页面。
