GraphQL POST请求返回字段值为Null的问题排查求助

1. 核对GraphQL类型与实体字段的映射逻辑 #

检查你的CategoryType定义，确保字段的解析器（resolver）正确从Doctrine实体中取值：

// 示例CategoryType字段定义
public function fields(): array
{
    return [
        'category_id' => Type::int(),
        'category_name' => Type::string(),
    ];
}

// 对应字段的解析方法
public function resolveCategoryId(Category $category): ?int
{
    // 必须调用实体正确的getter方法，比如$category->getCategoryId()
    return $category->getCategoryId();
}

public function resolveCategoryName(Category $category): ?string
{
    return $category->getCategoryName();
}

如果解析器里调用了错误的方法、或者实体没有对应的getter，就会返回null。

2. 验证实体类的属性访问权限与Getter #

Doctrine实体的属性通常是private/protected，必须提供正确的getter供GraphQL读取：

class Category
{
    /**
     * @ORM\Id
     * @ORM\Column(type="integer")
     */
    private $category_id;

    /**
     * @ORM\Column(type="string")
     */
    private $category_name;

    // 必须定义匹配的getter，注意大小写和命名规范
    public function getCategoryId(): ?int
    {
        return $this->category_id;
    }

    public function getCategoryName(): ?string
    {
        return $this->category_name;
    }
}

如果getter命名错误（比如写成getCategoryID）、或者未定义，GraphQL无法读取属性值，会返回null。

3. 确认查询字段名与实体字段完全匹配 #

你查询的category_id、category_name必须和实体中Doctrine映射的字段名完全一致，包括大小写。如果实体里是categoryId驼峰命名，而查询用了下划线，就会导致解析失败。

4. 检查Resolver中实体加载是否正常 #

在category查询的resolver里，直接打印实体数据，确认Doctrine确实拿到了有效值：

public function resolveCategory($args, $context)
{
    $category = $context['em']->getRepository(Category::class)->find($args['id']);
    // 打印验证实体字段值
    var_dump($category->getCategoryId(), $category->getCategoryName());
    return $category;
}

如果打印结果是null，说明Doctrine加载实体时就有问题（比如id=1的记录不存在、或实体映射错误）；如果打印有值，问题就出在GraphQL字段解析环节。

5. 排查子类继承映射的影响 #

如果Category有子类且使用了Doctrine继承映射（如SINGLE_TABLE/JOINED）：

• 确认子类没有覆盖父类的category_id/category_name字段；
• 检查GraphQL类型是否正确处理了继承（比如用Union或Interface类型），避免子类实例返回时无法解析父类字段。

6. 验证products集合映射是否干扰实体加载 #

虽然当前查询没请求products，但如果集合映射错误（比如关联的Product类不存在、mappedBy配置错误），可能导致Doctrine加载Category时抛出异常，而GraphQL吞掉错误返回空字段。可以暂时注释掉products的关联代码，重新测试：

// 临时注释关联映射
// /**
//  * @ORM\OneToMany(targetEntity="Product", mappedBy="category")
//  */
// private $products;

如果注释后字段正常返回，就说明是products的关联配置有问题，需要修正Doctrine映射。

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