Laravel Lighthouse：如何基于权限移除响应字段而非置空？

问题背景 #

基于Laravel Lighthouse搭建API，已实现自定义@scopedField指令用于权限控制，当前无权限时返回null，希望改为直接移除目标字段（如email），需明确可行性及推荐方案。

能否直接移除字段？ #

1. GraphQL规范限制 #

严格来说，不建议直接移除字段。根据GraphQL官方规范，Schema中定义的字段在客户端请求后，响应结构必须包含对应字段键——即便值为null。直接移除字段会破坏类型一致性，导致客户端解析逻辑报错（比如前端代码期望读取user.email却遇到未定义属性）。

2. 技术实现（若需强制移除） #

如果业务场景确实需要移除字段，可以修改自定义指令的逻辑，在解析完成后从结果中剔除目标字段：

<?php

namespace App\GraphQL\Directives;

use GraphQL\Type\Definition\ResolveInfo;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Facades\Gate;
use Nuwave\Lighthouse\Schema\Directives\BaseDirective;
use Nuwave\Lighthouse\Schema\Values\FieldValue;
use Nuwave\Lighthouse\Support\Contracts\FieldMiddleware;
use Nuwave\Lighthouse\Support\Contracts\GraphQLContext;

final class ScopedFieldDirective extends BaseDirective implements FieldMiddleware
{
    public static function definition(): string
    {
        return /** @lang GraphQL */ <<<'GRAPHQL'
directive @scopedField(
  """
  需要校验的权限能力
  """
  ability: [String]! = []
) on FIELD_DEFINITION
GRAPHQL;
    }
    
    public function handleField(FieldValue $fieldValue, \Closure $next)
    {
        $resolver = $fieldValue->getResolver();
        $currentField = $this->nodeName(); // 获取当前字段名（如email）

        $fieldValue->setResolver(function (
            $root,
            array $args,
            GraphQLContext $context,
            ResolveInfo $info
        ) use (
            $resolver,
            $currentField
        ) {
            $resolveResult = fn() => $resolver($root, $args, $context, $info);
            
            // 非模型/集合类型直接返回解析结果
            if (!$root instanceof Model && !$root instanceof \Illuminate\Database\Eloquent\Collection) {
                return $resolveResult();
            }
            
            $requiredAbilities = $this->directiveArgValue('ability');
            // 校验权限，无权限则移除字段
            if ($requiredAbilities && !Gate::check($requiredAbilities, $root)) {
                $result = $resolveResult();
                
                // 处理单个模型
                if ($result instanceof Model) {
                    unset($result->$currentField);
                    return $result->toArray();
                }
                // 处理模型集合
                elseif ($result instanceof \Illuminate\Database\Eloquent\Collection) {
                    return $result->map(function ($model) use ($currentField) {
                        unset($model->$currentField);
                        return $model->toArray();
                    });
                }
            }
            
            return $resolveResult();
        });
        
        return $next($fieldValue);
    }
}

注意：这种方式需要将模型转为数组返回，否则Eloquent模型的属性隐藏逻辑可能会干扰字段移除效果。

推荐方案：保留可空字段返回null #

从稳定性、兼容性和开发成本角度，强烈推荐继续使用返回null的方案，原因如下：

• 完全符合GraphQL规范，保证响应结构与Schema一致，避免客户端出现未定义异常。
• 客户端可以统一处理null值（比如显示"无权限查看"提示），逻辑更清晰可控。
• 实现简单，无需额外处理集合、嵌套字段等复杂场景，维护成本低。
• 已足够满足敏感数据保护需求：无权限时不会返回真实数据，仅返回null。

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