viewinit中间件会误将json()响应当作模板变量处理，导致返回html而非json；根本原因是它在响应构造阶段介入过早且无条件接管非response实例的返回值。
ViewInit中间件会把json()响应当成模板变量处理
ThinkPHP 默认启用 ViewInit 中间件，它的职责是自动初始化视图引擎、尝试渲染模板。当控制器返回 json($data) 时，框架本应直接输出 JSON 响应，但 ViewInit 会误判该返回值为「模板赋值变量」，进而试图调用 View::fetch() 渲染——结果就是你看到 Content-Type: text/html、响应体里包着 HTML 标签或空白页。
- 典型现象：
return json(['code' => 0])却收到... - 根本原因：ViewInit 在响应构造阶段介入太早，且无条件接管所有非 Response 实例的返回值
- 它不区分
json()和普通数组，只要控制器方法没显式返回\think\Response实例，就强行走视图流程
怎么确认是 ViewInit 拦截了你的 JSON
最直接的办法是临时禁用它，看 JSON 是否恢复正常：
- 在路由定义中加
->withoutMiddleware(\think\middleware\ViewInit::class) - 或在全局中间件配置
app/middleware.php中移除\think\middleware\ViewInit::class - 如果禁用后
return json(...)立刻返回标准 JSON，基本可锁定问题
绕过 ViewInit 的三种实操方式
不是所有场景都适合全局关掉 ViewInit（比如项目同时有 API 和后台页面），更稳妥的是按需绕过：
- 路由级关闭（推荐）：
Route::get('api/user', 'Api/UserController@index')->withoutMiddleware(\think\middleware\ViewInit::class); - 控制器方法注解（TP6.3+）：在方法上加
#[WithoutMiddleware(\think\middleware\ViewInit::class)] - 手动构造 Response 并跳过视图链：
return \think\Response::create(json_encode($data), 'json');—— 这个写法绕过了json()辅助函数，直接生成 Response 实例，ViewInit 不会再干预
为什么不能只靠中间件统一拦截修复
有人想写个全局中间件，在 $next($request) 后检查响应类型并重写，但这治标不治本：
-
ViewInit已在中间件链中提前污染了响应内容，$response->getContent()可能已是 HTML 字符串，无法安全反解 - 若控制器返回的是
['code'=>0]数组而非json()，中间件也无从判断原始意图是 JSON 还是模板变量 - 统一中间件更适合做「出口封装」，而不是补救被 ViewInit 错杀的响应
真正干净的做法，是让 JSON 响应从控制器开始就走对通道——要么关掉 ViewInit，要么确保返回的是框架认可的 Response 实例。ViewInit 的存在本身就是为了服务模板渲染，混用在纯 API 场景里，就是职责错位。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
