404路由失效主因是请求未进入Symfony内核，Web服务器（Apache/Nginx）提前返回404，故prod.log无记录；需检查Apache的AllowOverride All与.htaccess启用，或Nginx的try_files是否正确兜底至/index.php。
404 路由失效不是 Symfony 自身问题，而是请求根本没进到路由匹配环节——日志里找不到对应访问路径，说明 Web 服务器（Apache/Nginx）已提前返回 404，Symfony 连处理机会都没有。
为什么 var/log/prod.log 里查不到 404 访问记录
因为 Symfony 只对成功进入内核的请求才写日志。如果请求连 public/index.php 都没走到，就不可能触发 Symfony 的日志系统。
- 典型表现：
tail -n 20 var/log/prod.log完全空白，或最后一条日志是几小时前的缓存清除操作 - 真实原因：Web 服务器配置错误，比如 Apache 没启用
.htaccess，或 Nginx 的try_files没兜底到index.php - 验证方法：临时在
public/index.php开头加file_put_contents('/tmp/hit.txt', 'ok', FILE_APPEND); die();，再访问子域名；若文件没生成，说明请求根本没到这儿
Apache 下 .htaccess 不生效的硬核排查点
Symfony 2 默认依赖 .htaccess 实现 URL 重写，但很多生产环境默认禁用它。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 确认
AllowOverride All已在 VirtualHost 或目录配置中显式设置，仅AllowOverride FileInfo不够，RewriteRule需要FileInfo+Indexes权限 - 检查
public/.htaccess文件是否真实存在且权限为 644；某些 FTP 工具会静默丢弃以点开头的文件 - 运行
a2enmod rewrite并重启 Apache，否则RewriteEngine On直接被忽略 - 在
.htaccess末尾加一行Redirect 302 /test-rewrite /，访问/test-rewrite看是否跳转——不跳说明整个文件未加载
Nginx 中 try_files 顺序错一个字符就 404
Nginx 不读 .htaccess，必须靠 try_files 显式转发。常见错误是漏掉 =404 或路径写成 /index.php（少 public）。
- 正确写法：
try_files $uri $uri/ /index.php?$query_string;—— 注意结尾分号和$query_string不能省 - 如果用了 FastCGI，确保
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;中的$realpath_root指向public/目录，而非项目根目录 - 禁用所有缓存测试：
add_header X-Symfony-Status $status;，访问时看响应头是否出现X-Symfony-Status: 404（说明进了 Symfony）还是404无此头（说明 Nginx 自己返回的）
Symfony 2 路由定义本身导致的“假 404”
当请求确实进了 Symfony，但 prod.log 里有类似 Matched route "xxx" 却仍返回 404，问题出在控制器或前置逻辑。
- 检查路由是否绑定了
host条件但没匹配上，例如host: "{subdomain}.example.com"却没传subdomain参数 - Symfony 2 的
router:debug命令不显示 host 匹配结果，需手动执行php app/console router:match "/path" --env=prod并指定 Host 头：--options='{"HTTP_HOST":"admin.example.com"}' - 控制器方法名拼错、缺少
public修饰符、或返回了null（Symfony 2 不自动转空响应为 404，但某些 Bundle 会干预）
最常被忽略的是：Nginx/Apache 日志比 Symfony 日志更早暴露问题，先查 /var/log/nginx/error.log 或 /var/log/apache2/error.log 里的 “No input file specified” 或 “File not found”，那才是真正的第一现场。
