Symfony API Platform端点返回404错误求助

1. 验证路由是否实际注册 #

执行命令查看所有已注册的路由，确认Report相关的CRUD路由是否存在：

php bin/console debug:router

如果找不到api_reports_get_collection、api_reports_get_item这类路由，说明路由未正确生成，需重点检查文档类的注解配置。

2. 检查Report Document类的注解完整性 #

确保你的Report类包含必要的注解（API Platform 4.x使用PHP 8属性注解，而非旧版注解）：

<?php

namespace App\Document;

use ApiPlatform\Metadata\ApiResource;
use Doctrine\ODM\MongoDB\Mapping\Annotations as ODM;

#[ApiResource]
#[ODM\Document(collection: 'reports')]
class Report
{
    #[ODM\Id]
    private ?string $id = null;

    #[ODM\Field(type: 'string')]
    private ?string $title = null;

    // 其他字段及对应的getter/setter方法
}

注意：

• 必须添加#[ApiResource]注解，否则API Platform不会为该类生成端点
• #[ODM\Document]注解需明确映射到MongoDB集合（可选但建议指定）
• 主键字段必须标注#[ODM\Id]，其他字段需正确添加#[ODM\Field]注解

3. 确认MongoDB连接与文档映射配置 #

检查config/packages/doctrine_mongodb.yaml的配置是否正确：

doctrine_mongodb:
    connections:
        default:
            uri: '%env(MONGODB_URI)%'
            options: {}
    default_database: '%env(MONGODB_DB)%'
    document_managers:
        default:
            auto_mapping: true
            mappings:
                App:
                    is_bundle: false
                    type: attribute
                    dir: '%kernel.project_dir%/src/Document'
                    prefix: 'App\Document'

需确保：

• uri和default_database与你验证过的有效连接字符串一致
• 文档映射指向src/Document目录，且type设为attribute（匹配PHP 8属性注解）

4. 清除缓存并重新生成路由 #

执行缓存清除命令（开发环境）：

php bin/console cache:clear

再次运行debug:router确认路由是否生成。生产环境需确保缓存已完全重建。

5. 检查请求URL的正确性 #

确保curl请求的URL与docs页面显示的端点完全一致，比如列表端点应为GET /api/reports（而非/reports或其他路径）。示例验证请求：

curl -X GET http://your-domain/api/reports -H "Accept: application/ld+json"

若仍返回404，可通过响应头中的X-Debug-Token，执行php bin/console debug:bar {token}查看调试详情，定位路由匹配失败的具体原因。

6. 版本兼容性确认 #

你的版本组合理论上兼容：

• API Platform 4.x 支持 Symfony 6.4+（对应symfony/framework-bundle:6.4.14）
• Doctrine MongoDB ODM Bundle 5.x 兼容 Symfony 6.4+ 及 API Platform 4.x
  若问题仍存在，可尝试升级到各包的最新兼容小版本（如api-platform/symfony:4.1.x、doctrine/mongodb-odm-bundle:5.3.x）。

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