视图响应返回html页面，json响应返回结构化数据；前者用于浏览器直接渲染，后者专供js解析处理，二者不可混用且需严格匹配content-type头。
视图响应返回的是 HTML 页面，JSON 响应返回的是结构化数据
视图响应（比如 view() 或 render()）本质是把模板渲染成 HTML 字符串，再包装成 HttpResponse 或 Response 对象发给浏览器——浏览器收到后直接解析、展示页面。JSON 响应（如 JsonResponse 或 response()->json()）则把 Python 字典或 PHP 数组序列化为 JSON 字符串，并自动设置 Content-Type: application/json，专供 JS 脚本读取和处理。
- 用错场景：在 AJAX 成功回调里
res.text打印出一堆 HTML 标签？大概率后端误用了视图响应而非 JSON 响应 - 前端拿不到数据：如果 JS 用
res.json()解析，但后端返回的是text/html，会直接抛SyntaxError: Unexpected token - Laravel 和 Django 都不强制要求“必须用 JSON 响应做 API”，但如果你的路由被
fetch或axios调用，就该用response()->json(...)或JsonResponse(...)
JsonResponse 和 response()->json() 的状态码默认值不同
Django 的 JsonResponse 默认状态码是 200，但不会自动设 Content-Type 以外的头；Laravel 的 response()->json() 同样默认 200，但会额外禁用缓存（Cache-Control: no-cache, private），这是框架层面的差异，不是 bug。
- 需要返回错误数据时：Django 写
JsonResponse({'error': 'not found'}, status=404)；Laravel 写response()->json(['error' => 'not found'], 404) - 别依赖“没写 status 就是 200”——某些老版本 Laravel 在异常中断时可能返回 500，但 JSON 体为空，前端收不到提示
- 如果前端要读
X-Total-Count这类自定义头，Django 需手动加：res['X-Total-Count'] = '10'；Laravel 可链式调用：->header('X-Total-Count', 10)
文件下载、重定向不能和 JSON 响应混用
HTTP 响应只能有一种主体类型：要么是 JSON，要么是二进制流，要么是跳转指令。试图在一个响应里既输出 JSON 又触发下载，结果只会是前端收到乱码或空响应。
- 常见翻车：用户点击“导出 Excel”，后端却返回
{"success": true, "url": "/download/xxx.xlsx"}，然后让 JS 去window.location.href——这在 Safari 和部分安卓 WebView 里会被拦截（无用户手势） - 正确做法：导出操作用纯 GET 或 POST 提交表单，后端直接返回
response()->download(...)或FileResponse，不走 JSON 流程 - 重定向同理：
redirect()和JsonResponse是互斥的；想通知前端“操作完成，请跳转”，就返回 JSON 里带next字段，由前端判断后执行location.href
调试时先看响应头里的 Content-Type，再看内容
很多“前端解析失败”问题，根源不在数据结构，而在响应头没对上。浏览器或 fetch 会根据 Content-Type 决定怎么处理 body，哪怕内容确实是合法 JSON，只要头是 text/html，res.json() 就一定会报错。
- Chrome 开发者工具 → Network → 点开请求 → Headers → 查
Content-Type字段 - Django 视图中漏了
JsonResponse，写了HttpResponse(json.dumps({...}))？那Content-Type默认是text/html，必须显式传参：content_type='application/json' - Laravel 中用
return ['key' => 'val']确实会自动 JSON 化，但仅限于控制器方法返回数组且未启用其他中间件干扰；一旦加了日志中间件或修改了响应格式，就得显式调用response()->json()
text/html 头；或者前端用 await res.json()，但后端某条分支走了 return view(...) 却没统一兜底。这类问题不报错，只静默失败。
