如何将ASP.NET Core应用部署到ElasticBeanstalk并避免临时HTTP 404？

我之前维护小型后端服务时也碰到过一模一样的问题——单实例Windows环境下更新ASP.NET Core应用，总会出现短暂的HTTP 404错误。结合实际踩坑经验，分享几个有效的解决办法：

1. 配置应用程序预热（Application Initialization） #

这个方法能让Elastic Beanstalk在应用重启完成、完全就绪后再对外提供服务，避免启动过程中返回404。你需要修改项目根目录的web.config，添加应用初始化配置：

<configuration>
  <system.webServer>
    <!-- 启用应用初始化，重启后自动访问健康检查端点 -->
    <applicationInitialization doAppInitAfterRestart="true">
      <!-- 替换为你的应用健康检查路径，比如/health -->
      <add initializationPage="/health" />
    </applicationInitialization>
  </system.webServer>
</configuration>

确保你的ASP.NET Core应用已经实现了/health这类健康检查端点（可以用ASP.NET Core Health Checks中间件快速搭建），这样Elastic Beanstalk会等待这个端点返回成功状态后，才允许流量进入实例。

2. 手动实现蓝绿部署（零停机更新） #

虽然Windows平台不支持内置的Immutable或RollingWithAdditionalBatch策略，但我们可以手动模拟蓝绿部署流程：

• 第一步：在Elastic Beanstalk控制台创建一个和当前环境配置完全一致的新环境，部署你的应用新版本
• 第二步：验证新环境的应用运行正常（通过健康检查、手动测试接口）
• 第三步：在Elastic Beanstalk的环境管理页面，将域名切换到新环境
• 第四步：确认流量完全切换后，删除旧环境

这种方式完全不会影响现有服务的可用性，彻底避免临时404，适合对可用性要求较高的小型服务。

3. 优化健康检查配置 #

调整Elastic Beanstalk的健康检查规则，确保它不会在应用未就绪时就将实例标记为可用：

• 登录Elastic Beanstalk控制台，进入目标环境的「配置」页面
• 找到「实例」配置项，修改健康检查路径为你的应用健康端点（比如/health）
• 延长健康检查的超时时间和间隔时间（比如超时设为30秒，间隔设为10秒），给应用足够的启动时间

问题根源说明 #

目前Elastic Beanstalk的Windows Web角色确实不支持Immutable或RollingWithAdditionalBatch更新策略，官方暂未明确原因，但推测和Windows环境的文件锁定、部署机制有关。当使用单实例时，更新过程中唯一的运行实例会被停止、替换应用文件再重启，这个空档期内实例无法处理请求，就会返回HTTP 404。

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