Windows虚拟机IIS托管应用无法复制文件到Azure文件共享

核心问题根源 #

本地操作正常但IIS环境下失败，核心原因集中在会话隔离和权限配置两方面：挂载的Azure文件共享默认绑定登录用户会话，IIS进程无法访问；同时应用池身份缺乏共享读写权限。

1. 解决挂载盘的会话隔离问题 #

默认挂载的Z盘仅对当前登录用户可见，IIS应用池进程属于独立会话，无法识别该盘符。需执行全局系统级挂载：

• 打开系统级命令提示符（可通过psexec -s cmd工具启动），执行以下命令：

  net use Z: \\onegbuploadfileshare.file.core.windows.net\onefileshare /user:Azure\onegbuploadfileshare <你的存储账户密钥> /persistent:yes
  

  此命令会将共享挂载到系统会话，所有进程（包括IIS）均可访问Z盘。

2. 配置IIS应用池权限 #

• 使用系统账户（如Network Service）：在Azure存储账户的「访问控制（IAM）」中，给VM的系统分配身份添加「存储文件数据参与者」角色；
• 使用自定义账户：确保该账户在存储账户IAM中拥有读写权限，同时应用池身份具备本地文件读取权限。

3. 修正DOS复制命令的路径错误 #

你的命令存在路径冗余问题，正确写法二选一：

• 基于挂载盘的路径：

  /C copy /a C:\pubish\Files\1gb.test Z:\temp\newfile.test
  

• 直接访问共享（需带身份验证）：

  /C copy /a C:\pubish\Files\1gb.test \\onegbuploadfileshare.file.core.windows.net\onefileshare\temp\newfile.test /user:Azure\onegbuploadfileshare <存储账户密钥>
  

4. ShareClient方式的优化建议 #

避免依赖挂载盘符，直接通过API操作共享，确保权限配置正确：

string connectionString = "DefaultEndpointsProtocol=https;AccountName=onegbuploadfileshare;AccountKey=<你的存储账户密钥>;EndpointSuffix=core.windows.net";
ShareClient shareClient = new ShareClient(connectionString, "onefileshare");
ShareDirectoryClient directoryClient = shareClient.GetDirectoryClient("temp");
directoryClient.CreateIfNotExists();
ShareFileClient fileClient = directoryClient.GetFileClient("newfile.test");

using (FileStream stream = File.OpenRead(@"C:\pubish\Files\1gb.test"))
{
    fileClient.Upload(stream);
}

• 确保连接字符串/ SAS令牌包含写入权限；
• 添加异常捕获逻辑，定位具体错误（如权限拒绝、网络超时）。

5. AzCopy方式的正确用法 #

确保在IIS上下文下可执行，并使用有效授权：

• 基于SAS令牌：

  azcopy copy "C:\pubish\Files\1gb.test" "https://onegbuploadfileshare.file.core.windows.net/onefileshare/temp/newfile.test?<你的SAS令牌>"
  

• 基于VM系统身份（需提前配置IAM角色）：

  azcopy login --identity
  azcopy copy "C:\pubish\Files\1gb.test" "https://onegbuploadfileshare.file.core.windows.net/onefileshare/temp/newfile.test"
  

6. 辅助排查步骤 #

• 查看IIS日志和Windows事件查看器（应用程序/系统日志），提取具体错误代码；
• 用runas /user:"IIS AppPool\你的应用池名称" cmd切换到应用池身份，手动执行复制命令验证权限；
• 检查Azure文件共享的防火墙设置，确认VM IP在允许访问列表内。

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