.NET 6 Worker Service读取AZURE_TENANT_ID环境变量失败求助

可能的根本原因 #

• .NET 与.NET Framework环境变量读取逻辑差异
  .NET Framework会自动读取HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment路径下的注册表环境变量，但.NET 6的Environment.GetEnvironmentVariable默认仅读取当前进程的环境块。Windows服务启动时不会自动加载注册表中新增的环境变量，除非服务或系统重启；而.NET Framework应用可能因内部加载机制不同，能直接读取到注册表中的值。
• 服务启动权限限制
  如果.NET 6 Worker Service以非管理员身份运行，可能没有读取HKLM路径下注册表项的权限，而.NET Framework应用的运行权限更高，或其认证逻辑有特殊权限处理。
• 隐藏字符或键名异常
  即便拼写正确，注册表中的AZURE_TENANT_ID键名可能包含不可见控制字符（如空格、换行），导致读取失败。

解决方案 #

1. 刷新系统环境变量（无需重启系统） #

在Octopus Deploy的PowerShell脚本中，设置注册表后添加以下命令，通知系统刷新环境变量，之后重启Worker Service：

$signature = @"
[DllImport("user32.dll", SetLastError = true, CharSet = CharSet.Auto)]
public static extern IntPtr SendMessageTimeout(IntPtr hWnd, uint Msg, UIntPtr wParam, string lParam, uint fuFlags, uint uTimeout, out UIntPtr lpdwResult);
"@
$sendMessageTimeout = Add-Type -MemberDefinition $signature -Name Win32SendMessageTimeout -Namespace Win32Functions -PassThru
$HWND_BROADCAST = [IntPtr]0xffff
$WM_SETTINGCHANGE = 0x001A
$null = $sendMessageTimeout::SendMessageTimeout($HWND_BROADCAST, $WM_SETTINGCHANGE, [UIntPtr]0, "Environment", 2, 5000, [ref][UIntPtr]0)

2. 手动从注册表读取并设置变量 #

在Worker Service启动时，直接读取注册表中的AZURE_TENANT_ID并设置到进程环境变量，避免依赖系统加载：

using Microsoft.Win32;

// 在Program.cs的CreateHostBuilder前添加
using var registryKey = Registry.LocalMachine.OpenSubKey(@"SYSTEM\CurrentControlSet\Control\Session Manager\Environment");
if (registryKey != null)
{
    var tenantId = registryKey.GetValue("AZURE_TENANT_ID")?.ToString();
    if (!string.IsNullOrEmpty(tenantId))
    {
        Environment.SetEnvironmentVariable("AZURE_TENANT_ID", tenantId, EnvironmentVariableTarget.Process);
    }
}

var host = Host.CreateDefaultBuilder(args)
    .ConfigureServices(services =>
    {
        services.AddHostedService<Worker>();
    })
    .Build();

await host.RunAsync();

3. 检查服务运行权限 #

确保Worker Service的运行账户拥有读取目标注册表项的权限：

1. 打开注册表编辑器，右键HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment项，选择“权限”
2. 添加服务运行账户，赋予“读取”权限

4. 使用Octopus Deploy原生环境变量功能 #

直接在Octopus Deploy部署流程中为Worker Service设置进程级环境变量，而非手动修改注册表。Octopus会在启动服务时注入这些变量，确保.NET 6进程能直接读取。

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