.NET 8类Unix系统中P/Invoke修改环境变量未被.NET识别的问题

背景 #

截至.NET 8，.NET自带的环境变量API存在限制：无法定义值为空字符串的环境变量。而Windows和类Unix平台的原生系统调用均支持该特性，因此部分开发者选择通过P/Invoke直接调用系统调用实现需求，官方后续计划内置该能力。

问题现象 #

在.NET 8的Linux/macOS平台上，通过P/Invoke调用setenv修改环境变量后，出现以下不符合预期的表现：

• 直接通过系统调用（如getenv、system启动的子进程）能正确读取到新的环境变量值
• .NET自身的Environment.GetEnvironmentVariable API返回旧值或空值
• 通过.NET的Process.Start启动的子进程也无法读取到新设置的环境变量值

测试代码 #

以下是用于复现问题的C#控制台应用代码（基于.NET SDK 8.0.101）：

1. 将代码替换dotnet new console生成的Program.cs内容
2. 需在项目的.csproj文件的<PropertyGroup>节点中添加<AllowUnsafeBlocks>true</AllowUnsafeBlocks>以正常编译

using System.Diagnostics;
using System.Runtime.InteropServices;

partial class Program
{
  [LibraryImport("libc", StringMarshalling = StringMarshalling.Utf8)]
  private static partial int setenv(string name, string value, int overwrite);

  [LibraryImport("libc", StringMarshalling = StringMarshalling.Utf8)]
  private static partial IntPtr getenv(string name); // Convert to string with Marshal.PtrToStringUTF8()

  [LibraryImport("libc", StringMarshalling = StringMarshalling.Utf8)]
  private static partial int system(string command);

  static void ThrowSysCallError() => throw new System.ComponentModel.Win32Exception(Marshal.GetLastSystemError());

  static void Main(string[] args)
  {
    // Define / set env. var. 'FOO' with / to value 'new' 
    if (-1 == setenv("FOO", "new", 1)) ThrowSysCallError();

    Console.WriteLine(
      $"In-process value of FOO after setting it to 'new', via syscall: [{Marshal.PtrToStringUTF8(getenv("FOO"))}]"
    );

    Console.Write(
      "Value of FOO in a syscall-launched child process: "
    );
    system("echo [$FOO]");

    Console.WriteLine(
      $"In-process value of FOO per Environment.GetEnvironmentVariable(\"FOO\"): [{Environment.GetEnvironmentVariable("FOO")}]"
    );

    Console.Write(
      "Value of FOO in a .NET-launched child process: "
    );
    Process.Start(
      new ProcessStartInfo()
      {
        FileName = "sh",
        ArgumentList = { "-c", @"echo [$FOO]" },
      }
    )?.WaitForExit();

  }

}

预期输出 #

In-process value of FOO after setting it to 'new', via syscall: [new]
Value of FOO in a syscall-launched child process: [new]
In-process value of FOO per Environment.GetEnvironmentVariable("FOO"): [new]
Value of FOO in a .NET-launched child process: [new]

实际输出 #

In-process value of FOO after setting it to 'new', via syscall: [new]
Value of FOO in a syscall-launched child process: [new]
In-process value of FOO per Environment.GetEnvironmentVariable("FOO"): []
Value of FOO in a .NET-launched child process: []

问题原因 #

这并非代码疏漏，而是.NET的设计行为：
在类Unix平台上，.NET会在进程启动时将系统环境变量加载到自身维护的内存缓存中，后续Environment类的API以及Process.Start创建子进程时，均直接使用该缓存，不会实时同步系统层面的环境变量修改。

通过P/Invoke调用setenv仅修改了系统的环境变量表，并未更新.NET内部的缓存，因此.NET相关API无法识别到新值。

临时解决方案 #

如果需要让.NET识别到环境变量的修改，可在调用P/Invoke的setenv后，同时调用.NET的Environment.SetEnvironmentVariable更新内部缓存。对于空值环境变量的场景，可结合两者实现需求，或等待官方后续版本的内置支持。

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