.NET Core迁移静态类注册与DI调用异常排查

问题场景 #

• 原应用执行链路：OSMSelectController -> OSMDB_Loader.cs -> StatusController，负责读取连接字符串完成DAL层初始化
• 初始实现使用静态类存储连接字符串，调试时WPSGlobalSettings.ToolboxConnString字段值恒为null

静态配置类初始实现：

public static class WPSGlobalSettings
{
    public static NpgsqlConnectionStringBuilder ToolboxConnString = build_conn_str(ToolboxDatabaseName);

    private static NpgsqlConnectionStringBuilder build_conn_str(string dbname)
    {
        string dbSetting = ConfigurationHelper.config.GetSection("ConnectionStrings")["DefaultConnection"];
        // 省略连接字符串构建逻辑
    }
}

控制器初始实现：

public class StatusController : Microsoft.AspNetCore.Mvc.ControllerBase
{
    protected StatusDAL status_dal = new StatusDAL(WPSGlobalSettings.ToolboxConnString);
}

尝试将静态类注册为DI单例时抛出错误：

static types cannot be used as type arguments

当时的Startup.cs代码：

public void ConfigureServices(IServiceCollection services)
{
    services.AddSingleton<IConfiguration>(Configuration);
    services.AddControllersWithViews();
    services.AddSingleton<WPSGlobalSettings>();
    ConfigurationHelper.Initialize(Configuration);
}

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }

    WPSGlobalSettings.Configure(env);
    // 省略其余中间件配置
}

第一次改造的新问题 #

移除静态类单例注册代码后，改用DI方式给控制器注入配置：

// 移除手动初始化的DAL字段赋值
protected StatusDAL status_dal;

public StatusController(IConfiguration config)
{
    status_dal = new StatusDAL(config.GetConnectionString("toolboxConnectionStrWPS"));
}

此时旧代码OSMDB_Loader.cs中直接通过new关键字实例化控制器的逻辑报错：

public StatusAck LoadOSMSections(OsmLoadRequest request)
{
    StatusAck statusack = new StatusController().PostStatusRecord(); 
}

为适配该调用给控制器添加无参构造函数后，手动new出来的控制器实例中status_dal始终为null，逻辑完全不可用。

根因分析 #

1. 静态类型无法注册到.NET Core DI容器，DI容器仅支持创建非静态类型的实例，因此注册静态类会直接抛出类型参数错误
2. 静态字段初始化时机早于ConfigurationHelper.Initialize(Configuration)执行，此时配置对象还未完成赋值，读取到的连接字符串自然为null
3. ASP.NET Core中控制器实例由框架和DI容器统一管理，手动new的控制器实例不会走DI注入流程，无参构造没有初始化status_dal字段，必然出现null引用
4. 业务代码直接调用控制器是反模式：控制器是HTTP请求的入口层，不应该承载可复用的业务逻辑，更不能被其他业务类直接实例化

修复方案 #

推荐方案（符合.NET Core DI规范，长期可维护） #

1. 注册数据访问层到DI容器
   移除静态类注册逻辑，直接在服务注册阶段从配置读取连接字符串，初始化DAL并注册到容器：

   public void ConfigureServices(IServiceCollection services)
   {
       services.AddControllersWithViews();
       // 按业务场景选择生命周期，Web场景下DAL用Scoped即可
       services.AddScoped<StatusDAL>(sp =>
       {
           var connStr = Configuration.GetConnectionString("toolboxConnectionStrWPS");
           return new StatusDAL(new NpgsqlConnectionStringBuilder(connStr));
       });
       // 注册业务类OSMDB_Loader
       services.AddScoped<OSMDB_Loader>();
       ConfigurationHelper.Initialize(Configuration);
   }
   

2. 改造控制器，移除无参构造
   控制器通过构造函数直接注入DAL，不需要注入IConfiguration，也不要保留无参构造，避免绕过DI创建实例：

   public class StatusController : Microsoft.AspNetCore.Mvc.ControllerBase
   {
       private readonly StatusDAL _statusDal;
       public StatusController(StatusDAL statusDal)
       {
           _statusDal = statusDal;
       }
   
       public StatusAck PostStatusRecord()
       {
           // 仅处理HTTP请求相关逻辑，业务逻辑下沉到服务/DAL层
       }
   }
   

3. 重构业务类，移除手动new控制器的逻辑
   把原控制器中PostStatusRecord的可复用业务逻辑下沉到StatusDAL或者独立的服务类，OSMDB_Loader通过注入获取依赖，直接调用业务逻辑即可：

   public class OSMDB_Loader
   {
       private readonly StatusDAL _statusDal;
       public OSMDB_Loader(StatusDAL statusDal)
       {
           _statusDal = statusDal;
       }
   
       public StatusAck LoadOSMSections(OsmLoadRequest request)
       {
           // 直接调用下沉后的业务方法，完全不需要引用控制器
           StatusAck statusack = _statusDal.PostStatusRecord();
           return statusack;
       }
   }
   

   上层的OSMSelectController同样通过构造函数注入OSMDB_Loader即可，全程不需要手动new任何依赖对象。

临时兼容方案（适合短期无法大面积重构的场景） #

如果暂时无法移除全局静态类依赖，需要修正静态类的初始化时机，不要在静态字段声明时直接初始化，改为配置加载完成后显式赋值：

public static class WPSGlobalSettings
{
    public static NpgsqlConnectionStringBuilder ToolboxConnString { get; set; }

    public static void Init(IConfiguration config)
    {
        string dbSetting = config.GetConnectionString("DefaultConnection");
        ToolboxConnString = build_conn_str(dbSetting);
    }

    private static NpgsqlConnectionStringBuilder build_conn_str(string connStr)
    {
        // 连接字符串构建逻辑
    }
}

在Startup中配置初始化完成后，显式调用静态类初始化方法：

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllersWithViews();
    ConfigurationHelper.Initialize(Configuration);
    // 配置加载完成后再初始化静态字段，避免null
    WPSGlobalSettings.Init(Configuration);
}

注意：该方案仅为兼容旧逻辑的临时方案，长期维护建议迁移到标准DI模式，避免静态依赖带来的初始化顺序问题、单元测试困难等隐患。

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