Azure Pipelines部署ASP.NET Core应用时wwwRoot下Documents文件夹未部署

1. 检查项目文件(.csproj)的资源包含设置 #

ASP.NET Core默认仅部署项目中被包含的文件，若Documents文件夹或其中文件未添加到项目，发布过程会直接忽略它们：

• 右键项目中的Documents文件夹，选择包含在项目中
• 或手动编辑.csproj文件，添加以下配置强制发布文件夹内容：

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

2. 验证Azure Pipelines发布任务的文件规则 #

检查发布任务（如Azure App Service Deploy或IIS Web App Deploy）的配置细节：

• 确认Package or folder路径指向正确的发布产物，未排除wwwroot/Documents目录
• 若使用Web Deploy方式，检查Additional arguments中是否存在类似-skip:Directory=\\Documents的排除规则，如有则移除

3. 检查目标服务器的文件夹权限 #

即使发布任务正常，目标服务器的wwwroot目录权限限制可能导致Documents文件夹无法创建：

• 登录两台负载均衡服务器，确认IIS应用池标识对wwwroot目录拥有写入/修改权限
• 手动在服务器上创建Documents文件夹测试，若无法创建则调整权限设置

4. 分析发布日志定位问题 #

查看Azure Pipelines发布任务的完整日志：

• 搜索关键词Documents，确认发布过程中是否有跳过该文件夹的提示（如文件未找到、权限错误等）
• 检查Web Deploy的日志输出，定位具体的部署失败原因

5. 确保Take App Offline功能实际生效 #

虽然启用了Take App Offline，但可能因应用池未正确回收导致文件锁定：

• 在发布任务前添加IIS Web App Manage任务，手动回收应用池后再执行部署
• 或在目标服务器上手动停止应用池，重新触发发布任务

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