Api-Platform结合GraphQL在GraphiQL中返回Null问题求助

既然REST API能正常返回数据，说明你的实体映射、数据层逻辑都没问题，问题大概率出在GraphQL的配置、查询语法或者序列化规则上。我碰到过类似的情况，给你分享几个排查方向：

1. 确认实体的GraphQL支持是否正确配置 #

Api-Platform需要在实体上明确开启GraphQL支持，并且指定序列化规则。检查你的User实体注解：

/**
 * @ApiResource(
 *     graphql={
 *         "item_query"={"normalization_context"={"groups"={"user:read"}}},
 *         "collection_query"={"normalization_context"={"groups"={"user:read"}}}
 *     }
 * )
 * @ORM\Entity(repositoryClass=UserRepository::class)
 */
class User

• 必须在graphql数组里声明item_query（单条数据查询）和collection_query（列表查询），否则Api-Platform不会生成对应的GraphQL字段
• 检查实体字段是否添加了对应序列化组，比如：

/**
 * @ORM\Id
 * @ORM\GeneratedValue
 * @ORM\Column(type="integer")
 * @Groups({"user:read"})
 */
private $id;

如果字段没加user:read这类序列化组，GraphQL会因为数据被过滤而返回Null。

2. 检查GraphQL查询语法是否匹配Api-Platform默认规则 #

Api-Platform的GraphQL查询有固定的命名和结构规则，之前你试的语法可能不符合：

• 单条数据查询：用单数小写的实体名，参数是id，比如：

{
  user(id: 1) {
    id
  }
}

• 列表查询：用复数小写的实体名，而且默认返回的是连接（Connection）格式，必须通过edges.node获取数据，直接写users { id }会因为结构不匹配返回Null，正确写法是：

{
  users {
    edges {
      node {
        id
      }
    }
  }
}

3. 验证GraphQL端点和路由配置 #

检查config/routes/api_platform.yaml里的GraphQL路由是否正确配置：

api_platform_graphql:
    resource: .
    type: api_platform_graphql
    prefix: /api/graphql

确保你在GraphiQL里请求的是正确的端点（默认是/api/graphql），而且请求方法是POST（GraphQL标准请求方法）。

4. 查看Symfony日志定位错误 #

打开var/log/dev.log，执行GraphQL查询后搜索相关日志，比如：

• 序列化组缺失导致的警告
• 实体映射的异常
• GraphQL解析器的错误
  日志里的具体报错信息能帮你快速定位问题。

5. 确认GraphQL组件安装完整 #

虽然你按官方文档操作，还是可以再确认一下依赖是否安装到位：

composer require api-platform/graphql

安装完成后，用bin/console debug:container api_platform.graphql检查容器里是否有相关服务，确保组件正常加载。

最后，如果以上步骤都试过还是没解决，试试清空缓存：

bin/console cache:clear

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