Blazor Server应用上传文件至UNC路径时路径前缀异常问题排查

核心问题：UNC路径格式错误 #

你当前定义的root = "\\SomeRemoteServer"在C#字符串中实际仅表示单个反斜杠开头的路径（\SomeRemoteServer），这不符合Windows UNC路径的规范。Windows UNC路径要求必须以两个反斜杠开头（\\ServerName\ShareName），而C#字符串中反斜杠是转义字符，因此正确的写法有两种：

• 使用逐字字符串（避免转义）：var root = @"\\SomeRemoteServer";
• 手动转义双反斜杠：var root = "\\\\SomeRemoteServer";

当Path.Combine遇到单个反斜杠开头的路径时，会将其视为相对当前应用工作目录的路径。Blazor Server本地调试时默认工作目录通常在C盘，因此最终路径被拼接成C:\<remoteServerName>\...，这就是错误的根源。

修正后的代码示例 #

// 使用逐字字符串简化UNC路径写法
var root = @"\\SomeRemoteServer";
var folder = "destinationFolder";

string path = Path.Combine(root, folder, file.Name);
await using FileStream fs = new(path, FileMode.Create);
await file.OpenReadStream(maxFileSize).CopyToAsync(fs);

额外注意事项 #

• 本地调试无需部署IIS：只要路径格式正确，且应用运行账户（本地调试时为你的Windows账户）拥有共享目录的写入权限，F5调试即可正常运行。
• 权限验证：即使你本地能访问共享目录，也要确认应用运行的账户（部署到IIS后为应用程序池账户）具备该目录的写入权限。
• UNC路径完整性：确保SomeRemoteServer是有效的服务器名称/IP，destinationFolder是该服务器上已共享的目录（完整UNC路径格式应为\\Server\Share\SubFolder，若destinationFolder是共享根目录，直接用\\SomeRemoteServer\destinationFolder作为root更清晰）。

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