ASP.NET Core MVC部署Azure时wwwroot静态文件异常求助

核心问题分析 #

你遇到的两个现象里，lib目录依赖文件缺失是导致404的根本原因，而wwwroot嵌套属于ASP.NET Core应用的正常目录结构（静态文件中间件默认会从应用根目录下的wwwroot读取资源），无需刻意调整，只需解决依赖缺失问题即可。

解决方案：补全构建过程中的依赖恢复步骤 #

根据你管理前端依赖的方式，选择对应的修复方案：

方案1：使用LibMan管理客户端库 #

如果是通过LibMan安装的jquery、signalr等库，需要在GitHub Actions的构建流程中添加依赖恢复步骤：

# 在"配置.NET Core环境"步骤后添加
- name: 恢复LibMan依赖
  working-directory: ./${{ matrix.value }}
  run: dotnet tool restore && dotnet libman restore

若项目未安装LibMan工具，需先在.csproj文件中添加以下引用：

<DotNetCliToolReference Include="Microsoft.Web.LibraryManager.Cli" Version="2.1.113" />

方案2：使用npm管理前端依赖 #

如果是通过npm安装依赖，并通过构建脚本（如webpack）将资源同步到wwwroot，需添加Node.js环境配置和依赖构建步骤：

# 在"配置.NET Core环境"步骤后添加
- name: 安装Node.js环境
  uses: actions/setup-node@v4
  with:
    node-version: '20' # 根据项目实际Node版本调整

- name: 安装npm依赖
  working-directory: ./${{ matrix.value }}
  run: npm install

- name: 构建前端资源
  working-directory: ./${{ matrix.value }}
  run: npm run build # 确保package.json中存在build脚本，负责将资源复制到wwwroot

额外验证配置 #

1. 检查项目.csproj文件，确保wwwroot下的所有文件会被包含到发布输出：

<ItemGroup>
  <Content Include="wwwroot/**/*" CopyToPublishDirectory="PreserveNewest" />
</ItemGroup>

2. 本地测试：执行dotnet publish -c Release，查看输出目录下的wwwroot/lib是否包含完整的依赖文件（如jquery/dist、microsoft/signalr），确认本地发布正常后再重新触发GitHub Actions部署。

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