CI3用$this->output->set_content_type()+set_output()，CI4必须return service('response')->setJson()；二者混用必出错，且需注意中文转义、响应头顺序、Accept头校验等细节。
CodeIgniter 3 和 CodeIgniter 4 的 JSON 响应机制完全不兼容，混用必出空白页、500 错误或前端 JSON.parse() 失败 —— 别抄 Laravel 写法，也别在 CI4 里用 $this->output。
CI3 必须用 $this->output->set_content_type() + set_output() 组合
CI3 没有 json() 方法，$this->output->set_output() 是唯一可控的输出入口。手动设头 + 手动编码是标准路径，任何直接 echo json_encode() 或 header() 都可能被钩子覆盖、触发缓存冲突，或让 CORS 头失效。
-
set_content_type('application/json', 'utf-8')必须在set_output()之前调用，顺序反了响应头就丢了 - 务必加
JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES：漏掉JSON_UNESCAPED_UNICODE，中文变\u4f60\u597d；漏掉JSON_UNESCAPED_SLASHES，URL 字段里的/会被转成\/ - 控制器方法末尾不能有额外
echo、print_r或空行，否则 JSON 前多出空白字符，前端fetch().json()直接报Unexpected token - 如果用了自定义基类（如
MY_Controller），检查构造函数里是否提前调用了$this->output->set_output()，会覆盖后续输出
CI4 必须用 service('response')->setJson()，且必须 return
CI4 彻底弃用 $this->output，所有响应必须走 PSR-7 兼容的 Response 实例。直接 echo json_encode() 不仅不生效，还会破坏中间件生命周期，导致 CORS、CSRF 或日志记录失效。
- 获取响应对象只能通过
service('response')，不能new Response()，也不能用$this->response（除非你已绑定到控制器属性） -
setJson()自动设置Content-Type: application/json; charset=utf-8，无需手动设头 - 必须写
return service('response')->setJson($data)，漏掉return就是空白页 —— CI4 的响应对象是“构建后需显式返回”，不是自动输出 - 若需状态码，链式调用
setStatusCode(201)，别用http_response_code()，它绕过 PSR-7 流程 - 模型返回的
Result对象（如$model->find()）要先转数组：getResultArray()或getFirstRow('array')，否则json_encode()会失败或输出空
别信 is_ajax_request()，前端 Accept 头才是可靠依据
is_ajax_request() 只检查 X-Requested-With: XMLHttpRequest，但 Fetch API 默认不发这个头，Axios 也不带，容易把合法 API 请求当成普通页面请求，返回 HTML 模板而非 JSON。
- 更稳妥的做法是读取
Accept头：$this->request->getHeaderLine('accept') === 'application/json'（CI4）或$this->input->get_request_header('accept') === 'application/json'（CI3） - 或者统一约定自定义头，比如要求前端带
api-version: v2，后端据此判断是否走 JSON 响应流程 - CI4 中可直接用
$this->request->isAJAX()，但它内部也是查X-Requested-With，仍不推荐单独依赖
RestServer 的 Format::factory()->to_json() 是独立方案，不替代框架原生逻辑
RestServer 是第三方库，它的 Format 类封装了 JSON、XML、CSV 等六种格式输出，但和 CI 原生响应机制无关。它不走 $this->output（CI3）或 Response（CI4），而是直接 echo 输出，适合快速原型，但会绕过缓存、钩子、CORS 中间件等核心机制。
- 用它时，必须确保没开启输出缓冲（
ob_start()），否则echo被截住，前端收不到响应 -
to_json()默认不处理中文转义，需手动传参：to_json(['pretty' => false, 'unescaped_unicode' => true]) - 它支持 JSONP（自动识别 URL 中
callback=xxx），但现代 API 已基本淘汰 JSONP，优先用 CORS - 上线前务必确认：RestServer 的
echo是否和你的日志中间件、性能监控钩子冲突
最易被忽略的点：CI3 的 set_output() 和 CI4 的 setJson() 都依赖框架的输出生命周期管理，任何裸 echo、exit、die 或提前 header() 都会打断这个链条 —— 它们不是“辅助函数”，而是响应流程的强制关卡。
