64位环境下AWS Elastic Beanstalk PHP 7.4部署持续失败如何解决

报错日志如下：

2021-11-16 08:59:04 UTC+0000    
ERROR
During an aborted deployment, some instances may have deployed the new application version. To ensure all instances are running the same version, re-deploy the appropriate application version.
2021-11-16 08:59:04 UTC+0000    
ERROR
Failed to deploy application.
2021-11-16 08:59:04 UTC+0000    
ERROR
Unsuccessful command execution on instance id(s) 'i-09c35678ec1d7167c'. Aborting the operation.
2021-11-16 08:59:04 UTC+0000    
INFO
Command execution completed on all instances. Summary: [Successful: 0, Failed: 1].

2021-11-16 08:59:04 UTC+0000
ERROR
[Instance: i-09c35678ec1d7167c] Command failed on instance. Return code: 1 Output: Engine execution has encountered an error..

平台层差异故障 #

• 底层操作系统版本不兼容：PHP 7.3对应的EB平台大多基于第一代Amazon Linux AMI，而PHP 7.4的EB平台默认基于Amazon Linux 2，两者的系统目录结构、默认安装的系统包、服务管理方式都有较大差异，适配7.3环境的自定义配置在新系统下可能无法正常运行。
• PHP扩展缺失或版本不匹配：EB PHP 7.4环境默认预装的扩展数量较少，和你本地7.4 Docker镜像、旧7.3环境的扩展列表存在差异，如果应用依赖的gd、redis、memcached、imagick等扩展未安装，或者版本和应用要求不匹配，会导致引擎启动失败。可以通过正常运行的info.php页面对比扩展列表和Docker环境的差异。
• 自定义PHP配置不兼容：如果在应用根目录的.ebextensions文件夹中配置了自定义php.ini参数，部分7.3支持的参数在7.4中已经废弃或调整了有效值，会被EB部署引擎统一捕获为引擎执行错误，不会在表层日志显示。
• 文件权限错误：EB PHP环境的运行用户为webapp，如果应用的缓存、日志、上传等需要读写的目录没有给webapp用户开放权限，会导致应用初始化失败。Docker环境一般默认以root用户运行，不会触发权限类问题。
• 自定义部署脚本执行失败：如果.ebextensions目录中有部署时执行的自定义脚本，部分适配旧系统的脚本在Amazon Linux 2环境下会因为路径变动、依赖的系统包缺失等问题执行失败，直接终止部署流程。

应用层故障 #

• 错误级别配置差异：EB PHP 7.4环境默认开启E_ALL错误级别，部分在7.3环境、本地Docker 7.4环境中被忽略的警告（如未定义变量、废弃函数调用、隐式类型转换警告）会被提升为错误，导致引擎执行中断。
• Composer依赖不兼容：如果应用使用Composer管理依赖，EB部署时会自动执行composer install，如果composer.lock是在7.3环境下生成的，部分依赖包的版本仅适配7.3，会在7.4环境下安装失败。可以删除本地的composer.lock和vendor目录，在7.4环境下重新生成后再打包部署。
• 环境变量配置差异：EB的环境变量注入方式和Docker不同，如果应用依赖的部分环境变量没有在EB控制台配置，或者键名存在大小写差异、特殊字符未正确转义，会导致应用初始化失败。

基础设施层故障 #

• 实例资源不足：如果使用t2.micro等小规格实例，部署时执行composer install或者应用初始化过程中内存不足触发OOM，进程被系统终止，也会返回引擎执行错误，可以查看实例/var/log/messages日志确认是否有OOM记录。
• EB平台版本存在已知bug：如果使用的PHP 7.4平台分支版本较旧，可能存在已知的部署bug，可以尝试升级到最新的PHP 7.4平台版本后重新部署。

日志排查建议 #

当前获取的是EB表层部署日志，更详细的错误信息可以直接登录对应EC2实例，查看以下日志文件定位具体问题：

• /var/log/eb-engine.log：EB部署引擎执行日志
• /var/log/php-fpm/www-error.log：PHP运行错误日志
• /var/log/nginx/error.log（或/var/log/httpd/error_log）：Web服务错误日志

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