文件上传接口返回404但响应体为JSON，说明是Symfony2应用层抛出的NotFoundHttpException且被kernel.exception监听器转为JSON响应；需检查Content-Type是否为application/json、路由是否正确定义并支持POST、控制器是否正确注册，以及监听器是否仅对API请求生效。
文件上传接口返回 404 但内容却是 JSON 格式，说明请求已抵达 Symfony2 应用层，但路由未匹配或控制器未正确注册——不是 Nginx/Apache 的 404，而是 Symfony 自身抛出的 NotFoundHttpException，且被异常监听器转成了 JSON 响应。
确认是 Symfony 层 404 而非 Web 服务器 404
检查响应头：
– 若 Content-Type: application/json 且响应体类似 {"error":"Not Found"}，说明 kernel.exception 监听器已介入，这是 Symfony 内部 404；
– 若 Content-Type: text/html 且内容是 Nginx 默认 404 页面，则问题在反向代理或路由未透传，与 Symfony 无关。
检查路由定义是否支持 multipart/form-data
Symfony2 的路由默认不区分请求方法以外的内容类型，但需确保：
- 路由规则明确绑定
POST方法，例如：->method('POST')（使用 RouteCollection）或注解中写@Method("POST") - 路径末尾无多余斜杠（如
/upload/chunk/和/upload/chunk在 Symfony2 中被视为不同路由） - 上传接口 URL 没有被
access_control或自定义防火墙规则静默拦截（某些安全配置会直接返回 404 而非 403）
验证控制器是否被正确加载和映射
运行命令确认路由存在：
-
php app/console router:debug | grep upload（Symfony2 命令） - 若无输出，说明路由未注册；若有但 method 不匹配，说明请求方式不符
- 检查控制器类命名空间、继承关系（必须 extends
Controller）、action 方法是否 public 且无拼写错误
排查 JSON 化监听器误处理 404
如果监听器对所有异常无差别转 JSON，会导致本该返回 HTML 的后台管理 404 也被 JSON 化。应限制只处理 API 请求：
- 监听器中判断：
$request->getAcceptableContentTypes()是否包含application/json - 或通过路径前缀过滤，例如：
strpos($request->getPathInfo(), '/api/') === 0 - 避免将
NotFoundHttpException统一映射为 200 + JSON 错误体——它应保持 404 状态码，仅响应格式为 JSON
