ThinkPHP上传失败不返回JSON的根本原因是异常未捕获导致框架输出HTML错误页；必须用try...catch包裹上传逻辑，禁用exit/die，统一返回json()，并确保app_debug=false、路径在public下、权限正确。
ThinkPHP 上传失败时返回的不是 JSON？检查 exit 和 die 是否被误用
ThinkPHP 默认上传出错会抛异常或直接输出 HTML 错误页，根本不会走你写的 json() 响应逻辑。核心原因是：上传过程（比如 $request->file() 或 $file->move()）一旦失败，框架可能已触发错误处理流程，你的控制器后续代码压根没执行到。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 所有上传操作必须包裹在
try...catch中，别依赖“上传方法返回 false 就自己处理”——有些底层错误（如临时目录不可写）会直接触发 PHP warning + ThinkPHP 异常终止 - 禁止在上传逻辑里手动调用
exit、die或dump()，它们会中断响应流程，JSON 根本发不出去 - 确保控制器方法最后统一返回
json($data)，而不是 echo + exit - 如果用了自定义上传类或中间件，确认它没有偷偷调用
Response::create()->send()或类似强制输出的方法
ThinkPHP 6 的 File 对象 move() 后怎么安全返回 JSON？别漏掉 getInfo() 和 isValid()
很多人以为 $file->move() 成功就万事大吉，其实它只负责移动文件；如果想返回标准 API 数据（如路径、原始名、大小），必须显式调用 $file->getInfo() ——但前提是文件对象还有效。而 move() 后原 File 实例可能已被重置或失效。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先用
$file->isValid()判断上传是否合法，不合法直接返回json(['code'=>0, 'msg'=>'文件上传失败']) - 调用
move()前，先保存关键信息：$originalName = $file->getOriginalName()、$size = $file->getSize() -
move()返回的是think\File实例（移动后的），可用它的getRealPath()或拼接 URL 路径，但别再调getInfo()——它返回的是新文件信息，不含原始名等元数据 - 完整字段示例：
json(['code'=>1, 'data'=>['url'=>'/uploads/'.date('Ymd').'/'.uniqid().'.jpg', 'name'=>$originalName, 'size'=>$size]])
API 响应中文件路径拼错导致前端 404？ThinkPHP 静态资源路由和 public 目录权限是关键
返回的 url 字段看着对，但浏览器访问 404，大概率不是代码问题，而是路径没落在 public/ 下，或 web 服务器没配置静态资源路由。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 上传目标路径必须是
public/uploads/（或子目录），绝对不能写成runtime/uploads/或app/uploads/—— 后者无法被 Nginx/Apache 直接访问 - 确认
public/.htaccess（Apache）或 Nginx 配置里没有屏蔽uploads/目录的规则 - Linux 下检查
public/uploads目录权限：web 用户（如 www-data）需有读+执行权限（chmod 755），上传时还需写权限（chmod 775并确保组正确） - URL 字段建议用相对路径（如
/uploads/202405/abc.jpg），避免硬编码域名；前端用location.origin + url拼接更可靠
为什么前端收到的是 HTML 页面而不是 JSON？检查 Content-Type 和调试模式开关
最隐蔽的问题：开发环境开启 app_debug = true 时，ThinkPHP 出错会输出完整 HTML 错误页——哪怕你在控制器写了 json()，只要前面某处触发了未捕获异常，整个响应体就变成 HTML，Content-Type 也变成 text/html。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 上线前务必确认
app_debug = false，否则任何异常都会覆盖你的 JSON 响应 - 用浏览器 DevTools 的 Network 面板看响应头，重点核对
Content-Type: application/json是否存在；不存在说明响应被中途劫持或框架兜底了 - 如果用了多层封装（如 BaseService → UploadService），确保每一层都声明返回类型且不吞异常；尤其注意
__construct()中不要做可能失败的 IO 操作 - 临时加一行
header('Content-Type: application/json; charset=utf-8');在json()调用前，能快速验证是否是 header 覆盖问题（但长期应靠配置解决）
上传路径、异常捕获点、响应头控制这三处稍一松动，JSON 就会悄无声息变成 HTML 或空响应。没在 Network 里亲眼看到 status 200 + Content-Type 正确 + body 是 JSON 字符串，就别信“逻辑没问题”。
