调试 symfony api 应优先使用 debug:router 和 router:match 命令：前者列出全部路由并支持过滤与控制器详情查看，后者模拟请求精准定位 404、方法不支持或参数校验失败原因；同时确认 api platform 路由已正确加载且实体标记 #[apiresource]。
调试 Symfony 命令路由和 API 接口，关键不是翻代码、猜配置，而是用对命令看准匹配逻辑——尤其在开发阶段，90% 的 404、方法不支持、参数失败问题，一行命令就能定位。
查所有已注册的 API 路由
运行 php bin/console debug:router，立刻列出全部路由：路径、名称、HTTP 方法、控制器、是否启用等一目了然。
- 加 --show-controllers 显示完整控制器方法签名，确认是否绑定到正确类和动作
- 用 | grep api 或 | grep v1 快速过滤版本化接口（如
php bin/console debug:router | grep ^api_） - 查单个路由细节：如 php bin/console debug:router api_users_get_collection，会显示路径参数、默认值、正则要求（requirements）、选项（options）等
模拟真实请求，精准判断匹配结果
当访问 /api/v1/users 返回 404，不确定是没定义、方法错、还是参数不满足？用 router:match 模拟匹配过程：
- php bin/console router:match /api/v1/users —— 显示最终命中哪条路由，或明确提示“无匹配”“方法不支持”“参数 id 不满足正则”
- 指定方法：php bin/console router:match --method=POST /api/v1/posts
- 带请求头测试版本协商：php bin/console router:match "/api/users" --header="Accept-Version:v2"，验证 condition 表达式是否生效
确认 API Platform 是否真正挂载
执行 debug:router 却看不到任何 api_* 路由？大概率是 API Platform 主路由未启用：
- 检查 config/routes.yaml 是否包含且格式正确：
api_platform:<br> resource: '@ApiPlatformBundle/Resources/config/routing.yaml'
注意：不能缩进、不能加注释、不能漏掉冒号 - 运行 php bin/console debug:router | head -n 5 看是否有
api_entrypoint或api_jsonld_context；没有就说明未加载 - 若用了
make:entity --api-resource但没暴露，打开实体文件，确认顶部有 #[ApiResource]，而非仅#[ORM\Entity]
测试 API 请求与响应结构
功能测试中别手动构造 Request，用 Symfony 测试客户端直连：
- 在
WebTestCase子类中调用 $client = static::createClient() - 发 JSON 请求：
$client->request('GET', '/api/v1/users', [], [], ['HTTP_ACCEPT' => 'application/ld+json']); - 断言前先检查状态码：
$this->assertSame(200, $client->getResponse()->getStatusCode()); - 再解析内容：
$data = json_decode($client->getResponse()->getContent(), true);<br>$this->assertArrayHasKey('@id', $data);
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
