.NET发布程序使用\\?\路径符号启动时崩溃问题排查

问题场景 #

调试构建、发布构建下代码均可正常运行，手动执行发布目录中的可执行文件（如..\Application Files\WindowsApp1_1_0_1_0\WindowsApp1.exe）也能正常工作，但运行发布的.application文件启动程序时，抛出**“路径中包含非法字符”**错误。

使用\\?\前缀是为了支持长文件名，该特性从.NET Framework 4.7.2开始支持。

涉事代码（VB.NET） #

For Each f As String In IO.Directory.GetFiles("\\?\c:\")
    Console.WriteLine(f)
Next

环境 #

VS 2022发布WinForms VB.NET应用（.NET Framework 4.8）

原因解析 #

ClickOnce应用通过.application启动时，会在沙箱安全环境中运行，而\\?\是Windows原生的长路径前缀，并不被ClickOnce的路径解析机制兼容——ClickOnce的沙箱会对传入的路径做额外校验，将\\?\判定为非法字符序列，从而触发报错。

而直接运行exe文件时，程序在普通桌面环境执行，不受ClickOnce沙箱的路径校验限制，因此能正常识别\\?\前缀并处理长路径。

解决方法 #

要在.NET Framework 4.8下同时支持长文件名并兼容ClickOnce发布，推荐以下两种方案：

方案1：启用.NET内置长路径支持（无需手动添加前缀） #

从.NET Framework 4.6.2开始，微软提供了原生的长路径支持，无需手动添加\\?\前缀。只需在应用的app.config中添加如下配置：

<configuration>
  <runtime>
    <AppContextSwitchOverrides value="Switch.System.IO.UseLegacyPathHandling=false;Switch.System.IO.BlockLongPaths=false" />
  </runtime>
</configuration>

配置完成后，直接使用常规路径格式（如c:\）即可自动支持长文件名，同时完全兼容ClickOnce环境，不会触发非法字符报错。

方案2：针对ClickOnce环境动态切换路径格式 #

如果必须保留\\?\前缀的使用场景，可以通过判断运行环境动态调整路径格式：

Imports System.Deployment.Application

' 目标基础路径
Dim basePath As String = "c:\"

If ApplicationDeployment.IsNetworkDeployed Then
    ' ClickOnce环境下使用常规路径
    For Each f As String In IO.Directory.GetFiles(basePath)
        Console.WriteLine(f)
    Next
Else
    ' 非ClickOnce环境下使用长路径前缀
    For Each f As String In IO.Directory.GetFiles($"\\?\{basePath}")
        Console.WriteLine(f)
    Next
End If

注意：使用此方案需要在项目中添加对System.Deployment程序集的引用。

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