GitHub Actions部署ASP.NET Core到AWS Beanstalk部署失败解决方法
第一步:先拿到具体的失败错误详情
你现在从GitHub Actions、EB控制台总日志拿到的信息只有“Hook执行失败、输出为空”,根本定位不到根因,首先要拉取实例上的全量日志:
- 登录AWS控制台,进入
demovideo-dev环境的EC2实例列表,找到报错的实例i-094e9d57f5e05c25c - 在实例的日志管理页选择“请求最近日志包”,下载完整日志后重点查看
/var/log/eb-engine.log文件,这个文件会记录每一个部署Hook的执行行、报错位置,是定位这类Output: null错误的唯一依据
第二步:针对你的配置,优先排查3个最高发的踩坑点
结合你当前的macOS运行环境、.NET 3.1发布流程,绝大多数这类Hook报错都来自下面的问题:
1. macOS打包的冗余元数据导致包结构校验失败
你当前的打包命令是直接在out目录下用zip -r打全量文件,macOS自带的zip工具会自动往压缩包里塞__MACOSX目录、.DS_Store隐藏文件、文件系统资源分叉元数据,这些内容会被EB的部署Hook判定为非法包内容,直接终止执行,且不返回具体错误输出。
- 修正打包命令,增加
-X参数排除所有macOS冗余元数据,对应工作流步骤改成:
- name: Zip Package run: | cd ${{ github.workspace }}/out zip -r -X ${{ github.workspace }}/out.zip *
另外要注意,如果你的代码仓库根目录下有.ebextensions配置目录,里面的Shell脚本必须是LF换行格式,且适配Linux语法;如果把Windows格式的CRLF换行脚本、或者PowerShell脚本放到Linux环境的Hook目录下,Shell解析器根本没法识别脚本内容,就会出现执行返回1、且没有任何输出的情况,和你现在的报错表现完全一致。
2. 发布包的架构、权限与EB运行环境不匹配
你当前的dotnet publish是默认的跨平台发布,没有指定目标架构,加上macOS压缩包保留的权限位和Linux实例的要求不匹配,很容易出现两个问题:
- 发布出来的可执行文件没有
755执行权限,EB启动Hook调用应用时因为权限不足直接返回1 - 没有指定Linux x64目标运行时,发布的包架构和EB实例的Linux x64环境不兼容
- 修正发布与权限配置,对应步骤改成:
- name: Publish run: dotnet publish -c Release -r linux-x64 --self-contained false -o '${{ github.workspace }}/out' - name: Fix file permissions before zipping run: chmod +x ${{ github.workspace }}/out/*
3. 平台选型不匹配
你用macOS构建的跨平台.NET包,如果误选了EB的Windows Server平台,EB的Linux部署Hook(或者Windows的PowerShell Hook)根本没法执行跨平台发布的Linux可执行文件,会直接在Hook校验环节失败。
- 核对EB环境的平台配置:如果用跨平台publish的包,必须选择
Linux系列的.NET Core平台,不要选择Windows Server平台
第三步:清理残留异常状态再重新部署
你当前的环境已经处于Red/Degraded状态,实例上残留了之前失败部署的部分文件、Hook状态,直接重新部署很容易出现连续失败:
- 先在EB控制台对
demovideo-dev环境执行重建环境操作,把带异常状态的实例替换成全新的干净实例 - 再触发GitHub Actions的部署工作流,避免旧状态干扰新流程
内容的提问来源于stack exchange,提问作者Rahul Issar

