You need to enable JavaScript to run this app. 部署Laravel到Heroku遇Procfile解析失败及Forbidden无权限问题
优惠活动
大模型
产品
解决方案
定价
更多

部署Laravel到Heroku遇Procfile解析失败及Forbidden无权限问题

Laravel 7 应用部署至 Heroku 故障排查

已落地的基础配置

  • 首字母大写命名的Procfile,写入内容为:web: vendor/bin/heroku-php-apache2 public/
  • 应用根目录下的composer.json完整配置:
{
    "name": "laravel/laravel",
    "type": "project",
    "description": "The Laravel Framework.",
    "keywords": [
        "framework",
        "laravel"
    ],
    "license": "MIT",
    "require": {
        "php": "^7.2.5",
        "fideloper/proxy": "^4.2",
        "fruitcake/laravel-cors": "^1.0",
        "guzzlehttp/guzzle": "^6.3",
        "laravel/framework": "^7.0",
        "laravel/tinker": "^2.0"
    },
    "require-dev": {
        "facade/ignition": "^2.0",
        "fzaninotto/faker": "^1.9.1",
        "mockery/mockery": "^1.3.1",
        "nunomaduro/collision": "^4.1",
        "phpunit/phpunit": "^8.5"
    },
    "config": {
        "optimize-autoloader": true,
        "preferred-install": "dist",
        "sort-packages": true
    },
    "extra": {
        "laravel": {
            "dont-discover": []
        }
    },
    "autoload": {
        "psr-4": {
            "App\\": "app/"
        },
        "classmap": [
            "database/seeds",
            "database/factories"
        ]
    },
    "autoload-dev": {
        "psr-4": {
            "Tests\\": "tests/"
        }
    },
    "minimum-stability": "dev",
    "prefer-stable": true,
    "scripts": {
        "post-autoload-dump": [
            "Illuminate\\Foundation\\ComposerScripts::postAutoloadDump",
            "@php artisan package:discover --ansi"
        ],
         "post-install-cmd": [
            "php artisan clear-compiled",
            "chmod -R 775 public/"
        ],
        "post-root-package-install": [
            "@php -r \"file_exists('.env') || copy('.env.example', '.env');\""
        ],
        "post-create-project-cmd": [
            "@php artisan key:generate --ansi"
        ]
    }
}

实际遇到的两类构建/访问故障

  1. 大写P命名Procfile时的部署报错
    依赖安装流程全量完成、运行环境准备完毕后,进程类型识别环节直接终止部署推送,核心日志片段:
    ----- > Building on the Heroku-20 stack
    ----- > PHP app detected
    ----- > Bootstrapping...
    ----- > Installing platform packages...
           - php (7.4.14)
           - ext-mbstring (bundled with php)
           - apache (2.4.46)
           - nginx (1.18.0)
           - composer (2.0.8)
    ----- > Installing dependencies...
           依赖安装流程正常完成,包清单生成成功,已执行完php artisan clear-compiled和chmod -R 775 public/命令
    ----- > Preparing runtime environment...
    ----- > Checking for additional extensions to install...
    ----- > Discovering process types
     !     Push failed: cannot parse Procfile.
     !     Please try pushing again.
     !     If the problem persists, provide Request ID 4c5a16cd-17da-959b-0f2c-20c06971f06b.
    
  2. 小写命名procfile时的访问异常
    调整文件名为小写后,全流程构建无构建报错,但访问线上应用直接返回Forbidden无权限提示,对照Heroku官方Laravel部署指引操作后问题仍未解决。

问题根因与修复配置

  • Procfile解析报错的触发原因
    这类报错基本都来自文件本身的格式问题:本地编辑器保存Procfile时自动写入UTF-8 BOM头、换行符使用Windows CRLF格式、行尾残留不可见特殊空格。修复方式为:将Procfile重新保存为无BOM的UTF-8编码,换行符统一为LF格式,删除命令行末尾多余的空格,确认首行无其他冗余内容。
    注意:Heroku仅识别首字母大写、无扩展名的Procfile文件,小写命名的procfile会被构建流程直接忽略,不会作为web进程的启动配置依据——这也是改名小写后构建无报错、但公网访问返回Forbidden的核心原因:web进程没有按照指定路径启动,默认的站点根目录指向错误,最终触发权限拦截。
  • Forbidden访问报错的补全配置
    1. 调整composer.json的post-install-cmd配置,补全目录权限、密钥生成、配置缓存的逻辑,解决Laravel运行时的基础依赖问题:
      "post-install-cmd": [
          "php artisan clear-compiled",
          "chmod -R 755 storage",
          "chmod -R 755 bootstrap/cache",
          "php artisan key:generate --force",
          "php artisan config:cache"
      ]
      
      原配置中仅设置public目录权限的逻辑缺失了storage、bootstrap/cache目录的可写权限配置,Laravel会因为无法写入日志、缓存文件直接触发403拦截。
    2. 检查.gitignore配置,确认没有将Procfile排除在Git跟踪范围外,避免本地修改的文件根本没有推送到Heroku服务端。
    3. 调整Procfile中的站点路径写法,去掉末尾的多余斜杠:web: vendor/bin/heroku-php-apache2 public,部分环境下尾随斜杠会触发Web服务器的路径解析错误。

内容的提问来源于stack exchange,提问作者Igor M.

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.06 23:24:03