ElasticBeanstalk部署ASP.NET Core Web API出现502 Bad Gateway错误

核心问题分析 #

日志里的两个错误是连锁触发的：找不到System.Text.Json, Version=8.0.0.0程序集导致应用启动失败，进而抛出无法加载appsettings.json的错误（本质是应用启动流程中断，配置文件加载环节自然失败）。切换PostgreSQL本身不会直接引发这个程序集缺失问题，大概率是部署配置或.NET版本匹配出了疏漏。

具体修复步骤 #

1. 修正应用发布配置 #

确保发布ASP.NET Core应用时，采用**自包含部署（Self-Contained）**模式，把所有依赖的.NET程序集（包括System.Text.Json）打包进部署包，避免服务器缺失对应Runtime：

• Visual Studio发布：右键项目→发布→编辑配置→部署模式选「自包含」，目标运行时指定linux-x64（ElasticBeanstalk Linux环境默认是x64架构）。
• CLI发布：执行命令：

  dotnet publish -c Release -r linux-x64 --self-contained true
  

2. 匹配ElasticBeanstalk的.NET Runtime版本 #

登录AWS控制台，进入目标ElasticBeanstalk环境→配置→软件→在「.NET Core Settings」里确认Runtime版本设置为8.0.x。如果用框架依赖部署模式，服务器必须安装对应版本的Runtime，否则会出现程序集缺失。

3. 验证appsettings.json的存在与权限 #

• 解压本地部署包，确认appsettings.json和主dll文件在同一层级，没有被发布流程遗漏。
• 通过EB环境的「连接」功能登录EC2实例，检查文件状态并修复权限：

  # 确认文件存在
  ls -l /var/app/current/appsettings.json
  # 赋予可读权限
  sudo chmod 644 /var/app/current/appsettings.json
  

  保证dotnet进程能正常读取该配置文件。

4. 检查PostgreSQL驱动的兼容性 #

确认使用的Npgsql（PostgreSQL的.NET驱动）版本和.NET 8.0兼容，推荐用Npgsql 8.0.x版本，在项目csproj文件中验证：

<PackageReference Include="Npgsql.EntityFrameworkCore.PostgreSQL" Version="8.0.*" />

旧版本Npgsql可能和.NET 8存在依赖冲突，间接导致程序集加载失败。

5. 重新部署并排查详细日志 #

修复后重新打包部署到ElasticBeanstalk，查看/var/log/dotnet/dotnet.log路径下的应用启动日志，里面会有更具体的程序集加载失败堆栈，帮助定位剩余问题。

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