.Net MAUI使用接口实现依赖注入时无法解析服务报错排查

异常抛出的直接原因是服务注册语法错误。.NET MAUI 自带的依赖注入容器要求：注册接口与实现的映射时，必须同时在泛型参数中指定「服务类型（接口）」和「对应的实现类型」，你分开写两行单独注册实现类、单独注册接口的写法，容器无法建立IApiService和具体实现类的关联，且IApiService作为接口无法直接实例化，自然无法完成注入。

你写的builder.Services.AddSingleton<IApiService>()本质是要求容器直接注册IApiService类型本身的实例，这对接口来说是不可能完成的操作，这就是报错的核心原因。

1. 修正服务注册写法 #

删除分开写的两行注册代码，直接用单条语句完成接口到实现的映射：

• 测试环境使用本地数据源时：

// 注册IApiService的实现为LocalDataStore，生命周期为单例
builder.Services.AddSingleton<IApiService, LocalDataStore>();

• 生产环境切换远程数据源时：

// 注册IApiService的实现为RemoteDataStore
// 如果RemoteDataStore依赖HttpClient发请求，直接用AddHttpClient方法注册更方便，会自动注入配置好的HttpClient实例
builder.Services.AddHttpClient<IApiService, RemoteDataStore>();
// 注意：AddHttpClient默认注册的服务生命周期是瞬态，如果需要单例，可以手动追加生命周期配置

不需要单独额外注册LocalDataStore/RemoteDataStore，除非你的其他代码直接依赖具体实现类而非接口。

2. 实现环境自动切换 #

不需要每次切换环境手动修改注册代码，借助编译常量可以自动适配：

#if DEBUG
// 调试编译时自动使用本地数据源
builder.Services.AddSingleton<IApiService, LocalDataStore>();
#else
// 正式发布编译时自动使用远程数据源
builder.Services.AddHttpClient<IApiService, RemoteDataStore>();
#endif

所有ViewModel中只需要依赖IApiService接口，不需要做任何修改就能自动拿到对应环境的实现。

3. 修正ViewModel的异步逻辑问题 #

你当前在构造函数中用Task.Run包裹异步调用的写法存在隐患：构造函数无法追踪异步任务的状态，很容易出现异常未捕获、上下文丢失导致的死锁问题。构造函数只做依赖赋值即可，异步逻辑单独拆分：

public class Page1ViewModel
{ 
    private readonly IApiService _apiService;

    // 构造函数仅接收依赖并赋值，不执行业务逻辑
    public Page1ViewModel(IApiService apiService)
    {
        _apiService = apiService;
    }

    // 异步初始化逻辑，在页面OnAppearing生命周期、或者绑定页面加载命令时调用
    public async Task LoadDataAsync()
    {
        var result = await _apiService.GetSomething(true);
        // 后续数据处理、属性赋值逻辑
    }
}

记得同时将ViewModel、对应的页面也注册到DI容器中，否则容器也无法正常解析ViewModel实例：

// 注册ViewModel，一般用瞬态生命周期即可
builder.Services.AddTransient<Page1ViewModel>();
// 注册对应页面
builder.Services.AddTransient<Page1>();

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