Symfony集成API Platform时测试认证接口报404路由配置错误

核心现象 #

• Symfony框架集成API Platform场景下，参照官方测试示例编写身份认证逻辑
• 非测试环境authentication_token路由可正常处理登录请求、返回成功响应
• 仅测试代码调用该接口时返回404，报错为：Unable to find the controller for path authentication_token. The route is wrongly configured.

排查步骤 #

• 先验证测试环境路由是否真实注册
  执行命令php bin/console debug:router --env=test，在输出的路由列表中检索authentication_token，确认路由是否存在、对应的路径、请求方法、控制器配置是否和非测试环境一致。
• 核对测试请求的参数配置
  检查测试代码中发起请求的路径格式、请求方法：
  • 路径是否漏写前导/，比如误写为authentication_token而非/authentication_token
  • 请求方法是否匹配（该路由默认仅支持POST请求）
  • 若项目配置了全局API路径前缀（如/api），请求路径是否遗漏该前缀
• 检查测试环境配置覆盖项
  查看config/packages/test/、config/routes/test/目录下的配置文件，确认是否存在配置覆盖，意外移除了json_login对应的认证路由、或修改了防火墙匹配规则导致该路径被错误拦截。

可直接落地的解决方案 #

1. 补全测试环境路由注册
   若执行路由调试命令未找到authentication_token路由，在config/routes/test/下新建配置文件显式注册路由：

   # config/routes/test/authentication.yaml
   authentication_token:
     path: /authentication_token
     methods: ['POST']
     controller: api_platform.security.json_login
   

   如果项目配置了全局API前缀，将path调整为对应前缀后的路径即可。
2. 修正测试请求写法
   最常见的错误是请求路径漏写前导斜杠，错误示例：

   // 错误写法
   $client->request('POST', 'authentication_token', [
       'json' => [
           'username' => 'test_user',
           'password' => 'test_pass'
       ]
   ]);
   

   修正为正确写法：

   // 正确写法
   $client->request('POST', '/authentication_token', [
       'json' => [
           'username' => 'test_user',
           'password' => 'test_pass'
       ]
   ]);
   

3. 清理测试环境缓存
   执行命令清除测试环境缓存，避免旧缓存导致路由配置未加载：

   php bin/console cache:clear --env=test
   

若上述操作后仍异常，可检查测试用例的基类是否正确引导Symfony内核启动，是否存在自定义的请求监听事件在测试环境下篡改了请求路径。

内容的提问来源于stack exchange，提问作者yaraw69