升级至Laravel 9后DocuSign JWT认证报400 user_not_found错误

这个invalid_grant + user_not_found报错和Laravel 9升级直接相关，绝大多数同类案例都是升级后JWT生成环节参数丢失/格式错误导致的，和你之前配置的Integration Key、User Guid本身正确性无关。

DocuSign触发这个错误的逻辑很明确：服务端收到你提交的JWT断言，验签流程过了，但是解析payload里的sub（用户GUID）、iss（集成密钥）、aud（环境域名）字段时，匹配不到后台绑定的有效授权用户。

按优先级排查以下问题 #

• 第一优先级：检查升级后有没有跑过php artisan config:cache/php artisan optimize命令。Laravel 9对配置缓存逻辑做了调整，只要开启了配置缓存，所有不在config/目录文件内调用的env()函数会直接返回null。如果你的DocuSign SDK初始化、JWT生成逻辑里，是直接在控制器、服务提供者、中间件里用env()读DocuSign相关参数，缓存后这些值全是空的，生成的JWT自然匹配不到用户。
  修复方式：把所有DocuSign相关配置统一挪到config/services.php里：

  // config/services.php 新增配置段
  'docusign' => [
      'integration_key' => env('DOCUSIGN_INTEGRATION_KEY'),
      'user_guid' => env('DOCUSIGN_USER_GUID'),
      'private_key_path' => env('DOCUSIGN_PRIVATE_KEY_PATH'),
      'environment' => env('DOCUSIGN_ENV', 'account-d.docusign.com'),
  ],
  

  业务代码里统一用config('services.docusign.xxx')读取配置，绝对不要直接调用env()，改完跑php artisan config:clear清缓存再测试。
• 第二优先级：检查JWT生成依赖的版本兼容问题。Laravel 9默认依赖的firebase/php-jwt会升级到v6版本，这个版本的JWT生成方法签名和v5版本完全不兼容。如果你之前是自己写JWT生成逻辑，还沿用v5的JWT::encode($payload, $privateKey, 'RS256')写法，生成的JWT会出现签名异常、载荷字段错乱的问题，DocuSign解析时拿不到正确的sub字段就会报这个错。要么把firebase/php-jwt版本锁定到v5，要么适配v6的参数规则调整代码。
• 第三优先级：如果升级Laravel 9时同步把PHP升到了8.1+版本，检查RSA私钥的读取逻辑。Laravel 9调整了入口文件的工作目录逻辑，如果你的私钥路径写的是相对路径，会出现私钥读取失败的问题，生成的JWT签名无效也可能触发这个报错。可以在JWT生成前打个日志，确认私钥内容是完整读取到的，不是false或者空字符串。

快速定位技巧 #

调用DocuSign认证接口前，把生成好的JWT字符串拿出来，base64解码中间的payload段，直接看里面的iss、sub、aud三个字段是不是和预期值完全一致，有没有空值、缺字段的情况，1分钟就能确认是不是参数传递的问题。

小概率场景：如果解码后payload字段完全正常，再去DocuSign后台检查对应集成密钥的JWT授权范围有没有被重置，对应用户是不是还在应用的授权用户列表里，这个场景和Laravel升级无关，碰到的概率很低。

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