return是控制器动作的唯一合法退出方式，echo会提前输出破坏响应流程，导致headers already sent错误及JSON解析失败。
return 是控制器动作的合法退出方式，echo 会破坏响应流程
Yii2 控制器动作（actionXxx()）必须用 return 向框架交出数据，框架才能走完完整的响应生命周期。一旦你在动作里写 echo，就等于提前往输出缓冲区塞了内容，后续 Yii::$app->response->format = Response::FORMAT_JSON 会失效，报错 Headers already sent。
常见错误现象：
- 前端收不到 JSON，只看到空白或原始 HTML
- Chrome DevTools Network 面板显示响应类型是
text/html而非application/json - 日志里出现
PHP Warning: Cannot modify header information - headers already sent
正确做法是始终用 return 返回数组，让框架自动处理序列化和 header 设置：
public function actionLogin()
{
$model = new LoginForm();
if ($model->load(Yii::$app->request->post()) && $model->validate()) {
return ['success' => true, 'token' => $this->generateToken()];
} else {
return ['success' => false, 'errors' => $model->getErrors()];
}
}echo 不是“输出 JSON”，只是往 stdout 扔字符串
echo json_encode([...]) 看似能出 JSON，但它绕过了 Yii 的 Response 组件，不设 Content-Type、不处理编码、不触发 afterSend 行为，也不兼容中间件（如 CORS、日志记录）。更严重的是，它会让 $response->data 为空，导致你无法在 beforeAction 或 afterAction 中统一拦截或修饰响应。
使用场景对比：
-
echo：仅适合调试时临时打点（但建议改用Yii::info()写日志） -
return：所有正式接口的唯一推荐方式，无论成功或失败
性能与兼容性影响：
- 用
return时，框架会在send()前调用JsonFormatter，支持自定义序列化选项（如JSON_UNESCAPED_UNICODE） - 用
echo时，你得自己保证字符集、转义、缩进，且无法复用 Yii 的格式化配置
return 数组后，框架才真正开始干活
很多人以为 return 就是“把值扔出去”，其实它是把数据交给 Yii::$app->response->data，后续流程才启动：
- 框架检查
$response->format（比如是否设为Response::FORMAT_JSON） - 调用对应
Formatter（如JsonFormatter）执行json_encode($response->data) - 把结果赋给
$response->content，再调用echo $response->content
所以你不能在 return 之后再操作 $response->content，也不能指望 return 后还能执行后续 PHP 代码 —— 它就是动作的终点。
容易踩的坑：
- 在
return前写了var_dump()或echo，哪怕只有一行，都会让 header 发送失败 - 误以为
return $model->getErrors()就够了，没包进业务结构体，导致前端解析字段名对不上 - 忘记在控制器开头或
beforeAction()中设置Yii::$app->response->format = Response::FORMAT_JSON，结果返回的是 HTML 包裹的数组
命令行脚本里 echo 和 return 的语义完全不同
在 console 控制器（继承 yii\console\Controller）中，return 的值会变成 shell 的退出码（$?），而 echo 只是标准输出。如果你写：
public function actionTest()
{
echo "done\n";
return 0;
}shell 里 $? 是 0；但如果你写：
public function actionTest()
{
echo "done\n";
return 1;
}shell 里 $? 就是 1 —— 这才是判断任务成败的关键依据。很多自动化脚本靠这个做条件判断，用 echo 代替 return 会导致流程误判。
复杂点在于：Web 控制器和 console 控制器共用一套 return 语法，但语义不同。一个决定 HTTP 响应体，一个决定进程退出状态。这点最容易被忽略，尤其当团队同时维护 Web API 和后台任务时。
