Arch Linux上.NET 7使用System.IO.Ports遇NotSupportedException的解决咨询

问题根源 #

Arch Linux属于非官方预定义的Linux发行版，.NET运行时默认的RID（Runtime Identifier）识别逻辑无法匹配到System.IO.Ports包中对应的本地实现（.so文件），因此触发NotSupportedException；而显式引用DLL绕开了自动依赖解析，直接使用了兼容版本。

正确解决方案 #

1. 强制指定兼容的Runtime Identifier（RID）

• 临时生效：在终端执行以下命令后再运行程序，让.NET识别为标准x64 Linux环境：

  export DOTNET_RUNTIME_ID=linux-x64
  

• 永久生效：将上述命令添加到你的Shell配置文件（~/.bashrc或~/.zshrc），执行source ~/.bashrc（对应Shell）使配置生效。

2. 在项目文件中显式配置RID

打开项目的.csproj文件，添加或修改PropertyGroup节点，指定兼容的RID：

<PropertyGroup>
  <!-- 单RID配置 -->
  <RuntimeIdentifier>linux-x64</RuntimeIdentifier>
  <!-- 多RID配置（如需跨平台支持） -->
  <!-- <RuntimeIdentifiers>linux-x64;win-x64</RuntimeIdentifiers> -->
</PropertyGroup>

保存后执行dotnet restore重新恢复NuGet依赖，再构建运行项目。

3. 自包含发布确保依赖完整

如果项目需要发布到Arch Linux环境，使用自包含发布模式并指定RID，会自动打包对应平台的所有依赖（包括System.IO.Ports.Native.so）：

dotnet publish -r linux-x64 --self-contained

4. 验证本地库加载（用于排查）

若仍有问题，可启用.NET加载日志查看本地库是否被正确识别：

export DOTNET_DiagnosticPorts=:5000,suspend

使用dotnet-trace工具跟踪进程加载过程，确认runtimes/linux-x64/native/System.IO.Ports.Native.so是否被正确加载。

注意事项 #

不要采用手动复制DLL覆盖基础文件的临时方案，该操作可能导致版本冲突或后续更新时的依赖混乱，优先通过RID配置让.NET自动管理依赖解析。

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