控制器必须返回response对象，正确写法是return new response()；空响应应使用204状态码更语义准确，且需显式return，不可省略。
控制器返回空响应的正确写法是 return new Response()，不是不返回
Symfony 要求每个控制器动作（action）**必须返回一个 Response 对象**。如果你什么也不 return，PHP 会返回 null，框架捕获后抛出 LogicException: The controller must return a "Symfony\Component\HttpFoundation\Response" object —— 这不是警告，是致命错误，请求直接 500。
常见误操作包括：
- 只调用
$this->render()或$this->json()但没加return - 在条件分支里漏写
return（比如if有 return，else没有） - 想“静默执行”就干脆不写 return 语句
空响应 ≠ 不返回。空响应是指 HTTP body 为空、状态码为 200 的合法响应，适用于 webhook 回调确认、后台任务触发等场景。
正确做法：
use Symfony\Component\HttpFoundation\Response;-
return new Response();—— 默认 200，空 body，Content-Type: text/html - 如需指定状态码：
return new Response('', 204);（204 No Content 更语义准确） - 如需 JSON 空响应：
return new JsonResponse(null, 200);（注意不是new JsonResponse([])，后者返回[]）
为什么 $this->render() 或 $this->json() 必须加 return
这两个方法都返回 Response 对象，但它们只是“创建并返回”，**不会自动发送或终止流程**。控制器函数仍需显式 return 才能把该对象交还给 Symfony 内核。
典型错误写法：
public function triggerAction()
{
$this->json(['ok' => true]); // ❌ 没 return，函数返回 null
}
正确写法：
public function triggerAction()
{
return $this->json(['ok' => true]); // ✅
}
其他同理：return $this->render(...)、return $this->redirect(...)、return new RedirectResponse(...)。
返回空响应时要注意 Swiftmailer 内存假脱机（spool）
如果你的控制器在返回空响应前调用了发邮件服务（比如 $this->toolsService->sendMail()），而 Swiftmailer 配置了 spool: { type: 'memory' }，那邮件**根本不会发出** —— 因为内存假脱机依赖整个请求生命周期正常结束，而控制器没 return 会导致异常中断，假脱机队列被丢弃。
验证方式：
- 查看日志：如果
$mailer->send()返回1但收不到邮件，大概率是 spool 未 flush - 临时改成
spool: { type: 'file', path: '%kernel.cache_dir%/spool' }，看文件是否生成
解决办法：
- 确保控制器一定 return 一个
Response（哪怕new Response('', 204)） - 如需立即发信，禁用 spool：
spool: false，或手动 flush：$this->get('mailer')->getTransport()->flushSpool($this->get('mailer'));
不要用 die、exit 或 header() 终止响应
这些方式绕过 Symfony 响应生命周期，会导致：
- 事件监听器（如
kernel.response）不执行 - Profiler、日志、CORS 头丢失
- CLI 请求下行为不一致
空响应也应走标准流程：return new Response('', $statusCode); 是唯一干净、可测、可调试的方式。
最易被忽略的一点：空响应不是“没东西”，而是“有协议意义的无内容”。204 和 200 语义不同，前端或网关可能据此做重试判断 —— 别图省事全用 200。
