Laravel项目部署Heroku报错：heroku-php-apache2文件不存在

问题根源 #

这个错误是因为Heroku的PHP运行时脚本未生成，或者Procfile路径配置错误，大概率是依赖安装不完整、buildpack配置有误，或者Procfile格式不符合要求导致的。

具体修复步骤 #

• 确认PHP buildpack已启用
  先检查Heroku当前的buildpack列表，确保包含heroku/php：

  heroku buildpacks
  

  如果没有，添加该buildpack：

  heroku buildpacks:add heroku/php
  

• 修正Procfile内容
  Laravel的Web入口在public目录，Procfile必须指定正确的启动命令，内容需写成：

  web: vendor/bin/heroku-php-apache2 public/
  

  注意不要遗漏末尾的public/，否则不仅会找不到启动脚本，还会导致入口路径错误。

• 确保依赖正常安装
  本地先清理旧依赖并重新生成锁文件，避免Heroku部署时安装出错：

  rm -rf vendor composer.lock
  composer install --no-dev --optimize-autoloader
  git add composer.lock vendor
  git commit -m "Fix Heroku dependency issues"
  git push heroku main
  

  部署后实时查看日志，确认composer install步骤无报错：

  heroku logs --tail
  

• 指定兼容的PHP版本
  在composer.json的require块中明确PHP版本，比如Laravel 10要求PHP 8.1及以上：

  "require": {
      "php": "^8.1",
      // 其他Laravel核心依赖
  }
  

  PHP版本不匹配会导致Heroku安装的运行环境无法生成正确的启动脚本。

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