.NET类库中LaunchDarkly示例无法运行，控制台应用可正常执行

我在.NET Framework 4.8环境下集成LaunchDarkly Server SDK时遇到了一个问题：相同的初始化逻辑在控制台应用中可以正常连接，但迁移到类库（包括单例类）后，LdClient始终无法完成初始化，client.Initialized一直返回false。

可正常运行的控制台代码 #

using System;
using LaunchDarkly.Sdk;
using LaunchDarkly.Sdk.Server;
using Context = LaunchDarkly.Sdk.Context;

namespace HelloDotNet
{
    class Program
    {
        public const string SdkKey = "my-sdk-key";
        public const string FeatureFlagKey = "my-flag";
        
        private static void ShowMessage(string s)
        {
            Console.WriteLine("*** " + s);
            Console.WriteLine();
        }
        
        static void Main(string[] args)
        {
            var ldConfig = Configuration.Default(SdkKey);
            var client = new LdClient(ldConfig);
            
            if (client.Initialized)
            {
                ShowMessage("SDK successfully initialized!");
            }
            else
            {
                ShowMessage("SDK failed to initialize");
                Environment.Exit(1);
            }
            
            var context = Context.Builder("test")
                .Name("Sandy")
                .Build();
                
            var flagValue = client.BoolVariation(FeatureFlagKey, context, false);
            ShowMessage(string.Format("Feature flag '{0}' is {1} for this context",
                FeatureFlagKey, flagValue));
                
            client.Dispose();
            Console.ReadKey();
        }
    }
}

无法初始化的类库单例代码 #

using LaunchDarkly.Sdk.Server;
using System;
using LaunchDarkly.Sdk;
using System.Threading;

namespace FeatureFlags
{ 
    public class FeatureFlagsManager
    {
        private readonly string _sdkKey = "my-sdk-key";
        private Configuration _ldConfig;
        private LdClient _ldClient;
        private Context _context;
        private static readonly Lazy<FeatureFlagsManager> lazy = 
            new Lazy<FeatureFlagsManager>(() => new FeatureFlagsManager());
            
        public static FeatureFlagsManager Instance => lazy.Value;

        private FeatureFlagsManager()
        {
            _ldConfig = Configuration.Default(_sdkKey);
            _ldClient = new LdClient(_ldConfig);

            _context = Context.Builder("test").Name("Sandy").Build();
        }

        public bool GetFeatureFlagBool(string featureFlagKey)
        {
            return _ldClient.BoolVariation(featureFlagKey, _context, false);
        }
    }
}

补充：即使将控制台示例改为类库，把Main方法中的逻辑移入普通方法调用，同样会出现初始化失败的情况。

问题原因分析 #

1. 异步初始化的即时状态检查：LdClient的构造函数是异步完成初始化的，Initialized属性返回的是当前的即时状态，而非等待初始化完成后的结果。控制台应用中因为Console.ReadKey()阻塞了程序，给了SDK足够的时间完成初始化；但类库中构造函数执行后立即使用客户端，此时异步初始化可能还未完成。
2. 初始化时机与线程上下文：类库的单例可能在应用生命周期极早被实例化，此时应用的网络环境或线程上下文尚未准备就绪，导致SDK无法正常发起网络请求。
3. 缺少超时与等待逻辑：控制台示例中隐式的阻塞给了初始化缓冲时间，类库中没有类似逻辑，导致在初始化完成前就判定失败。

解决方案 #

1. 显式等待初始化完成 #

使用InitializeAsync()方法替代同步构造，确保等待初始化任务完成后再使用客户端：

private FeatureFlagsManager()
{
    _ldConfig = Configuration.Default(_sdkKey);
    // 同步等待异步初始化完成（注意：构造函数中使用Wait()需避免死锁风险）
    var initTask = LdClient.InitializeAsync(_ldConfig);
    initTask.Wait();
    _ldClient = initTask.Result;

    _context = Context.Builder("test").Name("Sandy").Build();
}

更安全的方式是提供异步初始化方法，在应用启动时主动调用：

public static async Task EnsureInitializedAsync()
{
    var instance = lazy.Value;
    if (!instance._ldClient.Initialized)
    {
        var newClient = await LdClient.InitializeAsync(instance._ldConfig);
        Interlocked.Exchange(ref instance._ldClient, newClient);
    }
}

在应用入口处调用：await FeatureFlagsManager.EnsureInitializedAsync();

2. 配置初始化超时 #

在Configuration中设置初始化等待时间，确保SDK有足够时间完成初始化：

_ldConfig = Configuration.Default(_sdkKey)
    .WithStartWaitTime(TimeSpan.FromSeconds(10)); // 设置10秒超时

3. 启用日志排查问题 #

开启Debug级日志，查看初始化失败的具体原因（如网络错误、密钥无效等）：

_ldConfig = Configuration.Default(_sdkKey)
    .WithLogging(Components.Logging().Level(LogLevel.Debug));

4. 验证网络与环境一致性 #

确保类库所在的应用拥有和控制台应用相同的网络访问权限，检查代理、防火墙规则是否限制了LaunchDarkly的API请求。

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