Symfony中GraphQL非开箱即用，必须显式选型（ApiPlatform或OverblogGraphQLBundle）、配置启用、暴露端点；默认无/graphql路由，404是因未执行graphql:true、安装webonyx/graphql-php、确认api_graphql_entrypoint路由存在。
Symfony 里没有“开箱即用”的 GraphQL API——你必须明确选型、显式配置、手动暴露端点，否则 /graphql 路由根本不存在，请求直接 404。
用 ApiPlatform 还是 OverblogGraphQLBundle？
ApiPlatform 更适合已有 REST API 的项目，能复用实体、序列化器和安全配置；OverblogGraphQLBundle 更灵活，适合需要精细控制 Schema 和 Resolver 的场景。两者不兼容，不能混用。
- ApiPlatform：依赖
@ApiResource和@ApiProperty注解，字段必须显式设readable: true才进 Query，graphQlRead: true才展开关联 - OverblogGraphQLBundle：靠 YAML 或 PHP 定义 Schema，Resolver 是独立类，可自由组合 Doctrine、API、缓存等数据源
- ApiPlatform 要求
symfony/serializer≥ 6.4；Overblog 对 serializer 版本无强约束
ApiPlatform 下 GraphQL 端点 404 怎么办？
不是漏配，是默认关闭。必须三步全做：
- 在
config/packages/api_platform.yaml中启用：graphql: true（不是enabled: true） - 运行
composer require webonyx/graphql-php（3.x 不再自动安装） - 执行
bin/console debug:router | grep graphql，确认api_graphql_entrypoint存在且 method 是 POST
如果仍 404，检查是否误把配置写在了 api_platform.php（PHP 配置格式不支持 graphql: true）。
OverblogGraphQLBundle 自定义端点路径
默认路由是 /graphql，但生产环境通常要改前缀，比如 /graphdata。只改一个文件：
#
config/routes/graphql.yaml
overblog_graphql_endpoint:
resource: "@OverblogGraphQLBundle/Resources/config/routing/graphql.yml"
prefix: /graphdata改完后端点就变成 POST /graphdata，前端 fetch 时 URL 就得同步更新。注意：这个 prefix 会作用于 Bundle 内所有子路由（包括 Playground），别加尾部斜杠。
GraphQL 查询返回空对象或 500 却没报错信息？
常见于类型推导失败或序列化冲突，错误日志藏在 Symfony Profiler 的「Logs」标签页，不在响应体里。
- 打开
config/packages/api_platform.yaml，加enable_profiler: true - 访问
/api/graphql?debug（ApiPlatform）或/graphdata?debug（Overblog），触发 GraphiQL 带调试模式的界面 - DateTime 类型务必用
DateTimeInterface+@ApiProperty(schema: {"type": "string", "format": "date-time"}) - DTO 当 input 时，
__construct()必须所有参数可选，否则解析器静默失败
最易忽略的是：GraphQL 层绕过 Symfony 的 kernel.controller 事件，监听器不会触发——想干预数据读写，得 hook QueryItemResolver 或自定义 Resolver。
