ABP框架单例服务依赖注入在Swagger中失败问题排查

我正尝试按照ABP官方文档在单层应用中将服务注册为单例。

接口定义 #

public interface ILObjectAppService: IApplicationService
{
    DateTime GetTime();
    string Login(string userName, string password, int frmNo);
    void Disconnect();
}

实现类代码 #

[Dependency(ServiceLifetime.Singleton, TryRegister = true)]
[ExposeServices(typeof(ILObjectAppService))]
public class LObjectAppService : ApplicationService, ILObjectAppService
{
    public static UnityObjects.UnityApplication _unityApp;

    private readonly IStatusAppService _statusAppService;
    public DateTime Time { get; set; }
    public LObjectAppService(IStatusAppService statusAppService)
    {
        _statusAppService = statusAppService;
        Time= DateTime.Now;
        _unityApp= new UnityObjects.UnityApplication();
    }

    public DateTime GetTime()
    {
        return Time;
    }
    // ... 其他方法
}

表现层使用正常 #

在Index.cshtml.cs中依赖注入使用完全正常：

public class IndexModel : AbpPageModel
{
    private readonly ILObjectAppService _lObjectAppService;
    public DateTime LObjectTime { get; set; }

    public IndexModel(ILObjectAppService lObjectAppService)
    {
        _lObjectAppService = lObjectAppService;
    }
    public async Task OnGetAsync()
    {
        LObjectTime = _lObjectAppService.GetTime();
    }
}

Swagger调用报错 #

访问Swagger调用LObjectAppService的GetTime接口时，出现500错误，日志显示：

Autofac.Core.Registration.ComponentNotRegisteredException: The requested service 'MyProject.Entegrator.Services.LObject.LObjectAppService' has not been registered. To avoid this exception, either register a component to provide the service, check for service registration using IsRegistered(), or use the ResolveOptional() method to resolve an optional dependency.

尝试在EntegratorModule.ConfigureServices()中通过context.Services.Singleton注册服务，直接导致应用崩溃。请问我的单例服务注册方式是否正确？最佳实践是什么？

错误原因 #

你使用[ExposeServices(typeof(ILObjectAppService))]仅暴露了接口类型，但ABP的Swagger/API控制器生成逻辑在处理应用服务时，会尝试直接解析实现类LObjectAppService，而该类型未被注册，因此抛出未注册异常。

另外，TryRegister = true意味着如果服务已存在则不重复注册，若之前有其他地方注册过该服务的不同生命周期，可能引发冲突；直接用context.Services.Singleton注册时崩溃，大概率是因为IStatusAppService的生命周期与单例不兼容（比如IStatusAppService是Scoped，单例依赖Scoped服务会触发容器报错）。

修复步骤 #

1. 调整ExposeServices属性：
   同时暴露接口和实现类，确保DI容器能解析两种类型：

   [Dependency(ServiceLifetime.Singleton, TryRegister = true)]
   [ExposeServices(typeof(ILObjectAppService), typeof(LObjectAppService))]
   public class LObjectAppService : ApplicationService, ILObjectAppService
   {
       // ... 原有代码
   }
   

2. 解决生命周期依赖冲突：
   如果IStatusAppService是Scoped或Transient类型，单例服务直接注入它会导致容器异常，可通过以下两种方式处理：

   • 若业务允许，将IStatusAppService也改为单例；
   • 使用IServiceProvider延迟解析Scoped服务，避免直接注入：

     private readonly IServiceProvider _serviceProvider;
     public LObjectAppService(IServiceProvider serviceProvider)
     {
         _serviceProvider = serviceProvider;
         Time= DateTime.Now;
         _unityApp= new UnityObjects.UnityApplication();
     }
     
     // 使用时创建作用域解析服务
     public void SomeMethod()
     {
         using var scope = _serviceProvider.CreateScope();
         var statusAppService = scope.ServiceProvider.GetRequiredService<IStatusAppService>();
         // 调用statusAppService方法
     }
     

单例服务注册最佳实践 #

1. 优先使用ABP特性注册：
   采用[Dependency]和[ExposeServices]特性是ABP推荐的方式，能与框架DI系统更好集成，避免手动注册引发的冲突。
2. 明确暴露所需服务类型：
   确保Swagger/API需要的所有类型（包括实现类）都被暴露并注册，避免解析失败。
3. 注意生命周期兼容性：
   单例服务不能直接依赖Scoped或Transient服务，必须通过IServiceProvider创建作用域延迟解析。
4. 避免重复注册：
   不要同时使用特性注册和手动context.Services.Singleton注册，否则会导致容器冲突。若必须手动注册，需去掉特性中的TryRegister = true，或确保注册逻辑唯一。

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