AWS CodePipeline部署.NET RazorPages至Elastic Beanstalk丢失静态文件

核心原因分析 #

你遇到的问题本质是CodeBuild构建阶段未将wwwroot下的静态文件纳入最终发布包，导致S3工件和Elastic Beanstalk实例中都缺失这些文件。以下是针对性的排查和修复步骤：

1. 检查并修正buildspec.yml配置 #

这是最可能的问题点，重点确认构建命令和工件打包规则：

完整示例buildspec.yml（适配.NET Razor Pages）

version: 0.2

phases:
  install:
    # 指定与本地一致的.NET SDK版本，避免版本差异导致的发布异常
    runtime-versions:
      dotnet: 6.0  # 替换为你的项目实际使用的.NET版本（如7.0、8.0）
  build:
    commands:
      - dotnet restore
      # 确保发布命令生成完整的产物，包括静态文件
      - dotnet publish -c Release -o ./publish
artifacts:
  # 打包publish目录下的所有文件，包括wwwroot
  files:
    - '**/*'
  base-directory: './publish'

关键配置说明

• runtime-versions：必须与本地开发环境的.NET版本一致，否则可能出现发布逻辑差异
• dotnet publish：默认会自动复制wwwroot下的静态文件，但如果CodeBuild环境版本不匹配，可能失效
• artifacts.files：**/*表示包含base-directory下的所有文件及子目录，确保wwwroot被纳入

2. 验证项目文件（.csproj）配置 #

虽然本地发布正常，但需确认项目未意外排除静态文件：
打开你的Razor Pages项目的.csproj文件，检查是否存在以下配置：

<ItemGroup>
  <!-- 确保静态文件被设置为发布时复制 -->
  <Content Include="wwwroot/**/*" CopyToPublishDirectory="PreserveNewest" />
</ItemGroup>

如果存在<Content Remove="wwwroot/**/*" />这类配置，需删除，它会阻止静态文件被复制到发布目录。

3. 查看CodeBuild构建日志定位问题 #

进入AWS控制台的CodeBuild项目，查看最近一次构建的日志：

• 搜索dotnet publish关键字，检查日志中是否有Copying file from "wwwroot/xxx"这类记录
  • 如果没有：说明发布命令未触发静态文件复制，大概率是.NET版本不匹配或项目配置问题
  • 如果有：说明静态文件已生成到./publish目录，但工件打包规则遗漏，需检查artifacts配置

4. 额外排查点 #

• 确认GitHub仓库中wwwroot文件夹及文件已正常提交，未被.gitignore排除
• 下载S3中的构建工件包解压检查，确认是否包含wwwroot目录：
  • 如果包含：问题出在Elastic Beanstalk部署阶段，需检查EB的应用配置（但你用Toolkit直接发布正常，此概率极低）
  • 如果不包含：问题锁定在CodeBuild构建阶段，回到前两步排查

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