You need to enable JavaScript to run this app. Heroku部署Laravel项目报oauth-public.key不存在500错误如何解决
优惠活动
大模型
产品
解决方案
定价
更多

Heroku部署Laravel项目报oauth-public.key不存在500错误如何解决

Laravel Heroku部署Passport公钥不存在问题解决方案

根本原因

Heroku使用临时文件系统,所有未提交到代码仓库的文件,都会在部署、dyno实例重启后被清空。Laravel Passport默认生成的oauth-public.key、oauth-private.key默认存放在storage目录,且默认被.gitignore排除,因此部署后会出现找不到密钥的报错。

推荐解决方案(安全优先级高)

  • 本地项目根目录执行命令生成密钥:php artisan passport:keys
  • 打开storage/oauth-public.key、storage/oauth-private.key两个文件,分别复制完整内容
  • 进入Heroku项目后台的设置页面,找到Config Vars配置项,新增两个环境变量:
    • 变量名PASSPORT_PUBLIC_KEY,值为刚才复制的公钥完整内容
    • 变量名PASSPORT_PRIVATE_KEY,值为刚才复制的私钥完整内容
  • 修改项目下config/passport.php配置文件,修改密钥读取逻辑:
    // 原配置
    // 'public_key' => storage_path('oauth-public.key'),
    // 'private_key' => storage_path('oauth-private.key'),
    
    // 替换为
    'public_key' => env('PASSPORT_PUBLIC_KEY'),
    'private_key' => env('PASSPORT_PRIVATE_KEY'),
    
  • 将修改后的配置文件提交到代码仓库,重新部署到Heroku即可生效

临时测试解决方案(安全性低,仅适合个人测试项目)

  • 编辑项目根目录的.gitignore文件,删除/storage/oauth-public.key、/storage/oauth-private.key相关的排除规则
  • 将本地生成的两个密钥文件直接提交到代码仓库,重新部署即可
  • 如部署后仍报不可读错误,可在Heroku的Procfile中新增release命令,补充权限配置:release: chmod 644 storage/oauth-public.key storage/oauth-private.key && php artisan migrate --force

内容的提问来源于stack exchange,提问作者stan

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.21 20:45:04