升级ThinkPHP后接口返回格式突然变了怎么调-ThinkPHP-PHP中文网

thinkphp6升级后接口返回异常需四步修复：①修改config/app.php中default_return_type为'json'；②统一用return json()或response()->json()替代echo json_encode()；③定义api_response()全局函数处理空数组转null及charset；④重写handler.php中render()方法确保api异常返回json。

升级thinkphp后接口返回格式突然变了怎么调

升级ThinkPHP后接口返回格式突然变成HTML包裹的JSON、空数组不转null、code字段消失或变成status、中文乱码、甚至直接500空白页——这不是前端改了，是TP6+默认行为与TP5.x彻底割裂，必须逐层对齐响应链路。

检查并重置默认返回类型

打开 config/app.php，找到 【'default_return_type' => 'html'】 这一行。TP6默认值是html，不是json，所有没显式调用json()的接口都会被推导为HTML响应。把它改成'default_return_type' => 'json'。

这一步必须做，否则后续所有return $data都会走HTML模板渲染逻辑，哪怕你写了header('Content-Type: application/json')也无效——框架在输出前已按default_return_type封装成Response对象。

统一替换控制器中的返回写法

把所有类似return ['code'=>0,'data'=>$user];或echo json_encode([...]);的写法全部删掉。

方法一：显式调用json()并强制头信息
直接写：return json(['code'=>0,'msg'=>'success','data'=>$user])->header('Content-Type','application/json; charset=utf-8');
注意：charset=utf-8不能省，否则中文字段在部分Android WebView里会显示为\u4f60\u597d。

方法二：用TP6.3+新增的response()->json()
return response()->json(['code'=>0,'msg'=>'success','data'=>$user]);
这个更安全，自动带charset=utf-8且可链式追加->withCookie(...)等操作。

⚠️关键提醒：绝对不要混用 echo json_encode() 和 return json() —— 前者绕过框架响应生命周期，中间件、日志、异常捕获全失效，且极易触发Headers already sent错误。

重构全局响应函数（推荐）

第一步：在app/common.php中定义标准函数

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

function api_response($code = 0, $msg = 'success', $data = null) {<br>
  return json([<br>
    'code' => (int)$code,<br>
    'msg' => (string)$msg,<br>
    'data' => $data === [] ? null : $data,<br>
    'timestamp' => time(),<br>
  ])->header('Content-Type', 'application/json; charset=utf-8');<br>
}

第二步：在所有控制器中替换原返回逻辑
① 找到所有return [...]语句
② 替换为return api_response(0, 'success', $data);或return api_response(400, '参数错误', []);
③ 空数组[]会自动转为null，避免前端解析时误判为“有数据”

第三步：检查是否加载了common.php
确认app/provider.php中'think\helper\Loader'已注册，或在入口文件public/index.php顶部手动require APP_PATH . 'common.php';。

修复异常响应被转成HTML的问题

打开 app/exception/Handler.php，定位到render()方法。

把原来的return parent::render($request, $e);替换成：

if ($request->isAjax() || $request->expectsJson() || $request->path() === 'api' || strpos($request->path(), 'api/') === 0) {<br>
  return response()->json([<br>
    'code' => 500,<br>
    'msg' => '服务器内部错误',<br>
    'data' => null,<br>
  ], 500);<br>
}<br>
return parent::render($request, $e);

这确保所有以api/开头的路由出错时，强制返回标准JSON结构，而不是带堆栈的HTML页面。