Azure Function混合连接访问本地服务器文件路径报错如何解决？

1. 初始路径识别错误：你最初使用的"\\servername\sample.csv"为普通字符串，C#中\为转义字符，实际运行时得到的路径为\servername\sample.csv，仅单个反斜杠开头会被系统识别为相对路径，因此会拼接上Azure Function的本地运行目录。
2. 后续访问被拒绝：路径格式修正后仍报错的核心原因有两个：
   • Azure Function默认运行身份为Azure端的本地虚拟账户，没有你本地服务器SMB共享的访问权限
   • 混合连接的配置或SMB协议的限制导致身份验证无法正常传递

方案1：修复直接SMB访问配置 #

第一步：使用正确的UNC路径格式 #

两种合法写法二选一：

• verbatim字符串（推荐）：@"\\服务器名\共享名\文件路径"
• 转义反斜杠："\\\\服务器名\\共享名\\文件路径"

第二步：主动提供SMB访问凭据 #

不要硬编码凭据，将用户名、密码存储在Azure Function的应用配置中，通过环境变量读取，示例代码：

using System.Net;
using System.Net.Cache;

// 读取配置中的本地访问凭据
var userName = Environment.GetEnvironmentVariable("LocalSmbUserName");
var password = Environment.GetEnvironmentVariable("LocalSmbPassword");
var domain = Environment.GetEnvironmentVariable("LocalSmbDomain"); // 无域环境可留空

// 给目标UNC路径注入访问凭据
var credentialCache = new CredentialCache();
credentialCache.Add(new Uri(@"\\ServerName"), "Negotiate", new NetworkCredential(userName, password, domain));

// 再访问共享路径
var files = Directory.GetFiles(@"\\ServerName\FolderName", "*.*", SearchOption.AllDirectories);

第三步：确认混合连接配置 #

• 混合连接的目标主机名必须和代码中写的服务器名完全一致，不能使用IP地址，混合连接依赖主机名做路由
• 混合连接的目标端口必须配置为445（SMB协议默认端口）
• 本地服务器防火墙开放445端口的入站访问

方案2：改用本地API中转（更稳定，推荐） #

SMB协议 over 混合连接存在较多身份验证、端口限制类的坑，更稳妥的实现方式如下：

1. 在本地服务器上部署一个轻量的API服务（如ASP.NET Core Web API），实现文件读取、枚举的专用接口
2. 将混合连接的目标端口配置为本地API的服务端口（如5000、80等）
3. Azure Function通过HTTP请求调用本地API的接口获取文件内容，无需处理SMB权限问题，还可以通过API密钥做身份校验，安全性更高

• 确认本地服务器上的混合连接管理器状态为已连接
• 确认目标共享文件夹对配置的访问账号开放了读取权限
• 若使用消费计划的Azure Function，需确认你的计划层级支持混合连接功能（弹性消费计划、专用计划均支持）

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