通过GitHub源码部署Laravel 10到AWS App Runner遇Composer错误的解决

问题根源 #

AWS App Runner官方提供的PHP 8.1运行时默认未预装Composer，直接执行composer install会触发"命令未找到"错误；移除该命令后，系统不会自动拉取依赖，导致项目因缺少vendor目录无法运行。

正确部署配置方案 #

1. 替换构建命令 #

将原有构建命令替换为先安装Composer再完成依赖安装的完整命令：

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" && php composer-setup.php --install-dir=/usr/local/bin --filename=composer && rm composer-setup.php && composer install --no-dev --optimize-autoloader && chmod -R 775 storage bootstrap/cache && chown -R www-data:www-data storage bootstrap/cache && php artisan config:cache && php artisan route:cache && php artisan view:cache

各部分作用：

• 下载并全局安装Composer，确保后续可直接调用命令
• --no-dev：跳过开发依赖，适配生产环境
• --optimize-autoloader：优化类自动加载机制，提升运行性能
• 调整存储目录权限，避免Laravel读写权限错误
• 生成配置、路由、视图缓存，提升应用响应速度

2. 优化启动命令 #

放弃仅适合开发环境的php artisan serve默认写法，改为：

php artisan serve --host=0.0.0.0 --port=80

必须添加--host=0.0.0.0，否则服务仅能在容器内部访问，App Runner无法对外提供服务。

3. 配置必要环境变量 #

在App Runner的"配置文件"步骤中，添加Laravel运行必需的环境变量：

• APP_KEY：本地执行php artisan key:generate --show生成的应用密钥
• APP_ENV：设置为production
• APP_URL：App Runner分配的服务域名
• 数据库连接信息（如使用数据库）：DB_HOST、DB_PORT、DB_DATABASE、DB_USERNAME、DB_PASSWORD

完整部署步骤 #

1. 创建App Runner服务，选择"源码仓库"类型，连接目标GitHub项目，设置自动部署触发
2. 进入"配置文件"环节：
   • 运行时选择PHP 8.1
   • 端口保持80
   • 构建命令填入上述完整命令
   • 启动命令填入优化后的php artisan serve命令
3. 添加所需环境变量
4. 完成服务创建，等待部署流程执行完毕

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