Azure存储账户显示已挂载但实际未生效（Windows App Service）

针对你遇到的配置显示正常但看不到挂载点的情况，我整理了几个实战排查和解决步骤：

1. 先确认挂载路径的访问方式是否正确 #

Windows App Service的挂载存储不会自动在Kudu文件管理器左侧导航里显示，你得手动切换到对应路径查看：

• 打开Kudu控制台（通过App Service门户的「高级工具」进入），选择CMD终端
• 执行命令 dir D:\home\test 直接查看挂载目录内容，如果能看到你上传的文件，说明挂载已经生效，只是Kudu文件管理器没自动刷新挂载点而已。

2. 检查存储挂载的核心配置是否正确 #

即使配置状态显示"ok"，也可能存在参数细节错误：

• 确认挂载路径格式：Windows环境下必须用D:\开头的绝对路径，比如D:\home\test或D:\home\site\wwwroot\storage，不能用Linux风格的斜杠路径
• 确认存储类型和共享名称：挂载时指定的--storage-type必须是AzureFiles，--share-name要和你存储账户里的文件共享名称完全一致（大小写敏感）
• 验证存储权限：如果用账户密钥挂载，确认密钥是存储账户的主密钥或副密钥；如果用SAS，要确保SAS包含「读取、写入、列表」等必要权限，且未过期

3. 强制重启App Service实例 #

Windows环境下，存储挂载配置生效有时候需要实例重启才能完成映射：

• 进入App Service门户，点击顶部的「重启」按钮，等待实例重启完成后，再去Kudu控制台查看挂载目录

4. 检查App Service的定价层 #

只有Basic、Standard、Premium、Isolated这几个付费层支持挂载自定义存储，Free和Shared层即使配置成功也无法实际生效，会导致挂载点不可见。如果你的App Service是免费层，需要先升级到付费层。

5. 用系统命令验证SMB映射状态 #

Windows App Service挂载Azure文件共享本质是通过SMB映射实现的，你可以在Kudu的CMD终端执行：

net use

如果看到类似 Z: \\xxx.file.core.windows.net\myshare 的映射条目，说明存储已经成功挂载，只是路径访问的问题；如果没有这个条目，说明挂载配置存在隐性错误，建议删除现有配置后重新添加。

6. 代码中访问路径的注意事项 #

如果是在应用代码中访问挂载文件，要确保使用正确的绝对路径：

• 比如ASP.NET应用可以用 Server.MapPath("~/test")（如果挂载到D:\home\site\wwwroot\test），或者直接使用绝对路径D:\home\test

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