如何在Azure App Service中为遗留ASP.NET应用生成并提供webroot文件？

核心原因 #

Azure App Service部署后，wwwroot目录默认是只读的，这是平台的安全限制，防止部署的代码被意外篡改，所以无法直接写入该目录。

可行实现步骤 #

1. 创建可写的存储目录
   在Azure App Service的控制台（Kudu或门户内置控制台）执行命令：

   mkdir D:/home/site/PDFs
   

   D:/home/site下的自定义子目录默认拥有写入权限，且符合虚拟目录映射的路径要求。

2. 配置虚拟目录映射
   在Azure门户进入你的App Service，依次操作：

   • 左侧菜单「配置」→「路径映射」
   • 点击「添加虚拟目录」，填写：
     • 虚拟路径：/PDF
     • 物理路径：site/PDFs（Azure会自动解析为完整路径D:/home/site/PDFs）
   • 保存配置并重启App Service生效。

3. 代码中写入目标目录
   不要使用Server.MapPath（受沙箱限制无法跳出wwwroot），改用环境变量获取根路径拼接目标目录：

   // 获取Azure App Service的home目录
   string homeDir = Environment.GetEnvironmentVariable("HOME");
   // 拼接PDF存储目录
   string pdfStoragePath = Path.Combine(homeDir, "site", "PDFs");
   // 确保目录存在
   if (!Directory.Exists(pdfStoragePath))
   {
       Directory.CreateDirectory(pdfStoragePath);
   }
   // 生成文件到该目录（示例）
   string filePath = Path.Combine(pdfStoragePath, "file.pdf");
   File.WriteAllText(filePath, "测试PDF内容");
   

4. 验证访问
   文件生成后，直接访问https://my-appservice.com/PDF/file.pdf即可获取该文件。

为什么之前的方法无效？ #

• Path.GetTempPath()对应的D:/local/temp是临时目录，会被定期清理，且不在site或mounts路径下，不符合虚拟目录映射规则。
• Server.MapPath("~/..")被ASP.NET的沙箱安全机制限制，无法跳出wwwroot目录范围。

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