Lighthouse单元测试中自动模型检测失效问题求助

首先，这个问题确实挺棘手——明明GraphQL Playground里一切正常，单元测试却掉链子，核心原因大概率是测试环境下Lighthouse的自动模型推断逻辑和常规请求环境存在差异，导致@can和@create指令无法正确定位到你的ClientName\PackageName\Models\User模型。

可能的原因拆解 #

1. 测试环境的配置加载问题
   有时候单元测试会使用独立的配置文件，或者缓存的配置没有更新，导致Lighthouse无法读取到你在providers里配置的模型映射。比如测试环境下config('lighthouse.providers.users')可能没有正确加载到你的自定义User模型，直接导致自动推断失败。

2. 模型推断的上下文缺失
   Lighthouse的@can和@create指令在自动推断模型时，依赖请求上下文或返回类型的解析。在单元测试中，请求上下文可能和Playground的真实HTTP请求有差异——比如缺少某些请求头、身份验证上下文初始化不完整，或者Lighthouse的类型解析器没有正确关联到你配置的模型，导致无法从返回类型User匹配到对应模型。

3. 批量赋值的隐性问题
   当@create指令无法正确推断模型时，可能会 fallback到默认的App\Models\User（如果项目里存在这个类的话），而这个默认模型的$fillable字段可能只包含email，所以你会看到只有email字段被更新。手动指定model参数后，指令正确使用了你的自定义模型，批量赋值就恢复正常了。

解决办法和排查步骤 #

• 先确认测试环境的配置
  在单元测试中加一行调试代码，确认Lighthouse的配置是否正确加载：

  dd(config('lighthouse.providers.users'));
  

  如果输出的模型类不是你期望的ClientName\PackageName\Models\User，那就是配置加载的问题——检查测试环境的config/lighthouse.php是否正确，或者有没有运行php artisan config:cache导致配置缓存未更新。

• 显式指定模型（你已经验证的有效方案）
  像你做的那样，在@can和@create指令中手动指定model参数，这是最直接的 workaround，完全绕过自动推断的问题：

  type Mutation @protect(guards: ["api"]) {
    "Create user"
    createUser(data: NewUserInput! @spread): User 
      @can(ability: "create" model: "ClientName\\PackageName\\Models\\User") 
      @create(model: "ClientName\\PackageName\\Models\\User")
  }
  

  这个方案虽然繁琐，但能确保测试和生产环境的行为完全一致。

• 检查测试中的身份验证上下文
  确保单元测试中你登录的测试用户拥有create权限，并且使用的是api guard。有时候测试中创建的用户没有正确关联到你的User模型，或者权限设置有误，导致@can指令报错。可以在测试中输出当前用户的模型类：

  dd(auth('api')->user()::class);
  

  确认是你的自定义User模型。

• 清除测试环境的缓存
  运行以下命令清除配置和路由缓存，确保Lighthouse使用最新的配置：

  php artisan config:clear
  php artisan route:clear
  php artisan lighthouse:clear-cache
  

总结 #

这个问题本质是Lighthouse在测试环境下的自动模型推断逻辑不够健壮，无法正确关联到你的自定义模型。显式指定model参数是最稳妥的解决方案，如果你想深挖根源，可以查看Lighthouse的CanDirective和CreateDirective源码，看看测试环境下模型推断的逻辑哪里出了问题。

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