运行时获取依赖 → 编译时注入

plainGeekDev2026-08-04 14:50

运行时获取依赖 → 编译时注入

老写法（Java --- 运行时获取）

java 复制代码

//  Service Locator 模式
public class ServiceLocator {
    private static Map<Class<?>, Object> services = new HashMap<>();

    public static <T> void register(Class<T> type, T instance) {
        services.put(type, instance);
    }

    public static <T> T get(Class<T> type) {
        return (T) services.get(type);
    }
}

ServiceLocator.register(ApiService.class, apiService);
ApiService api = ServiceLocator.get(ApiService.class);

//  反射创建
ApiService api = (ApiService) Class.forName("com.example.ApiService").newInstance();

问题在哪里

Service Locator 是运行时查找依赖，类型匹配失败编译期不报错。HashMap<Class<?>, Object> 是 Object 类型，每次 get 都要强转。依赖缺失或循环依赖的 bug 只在运行时暴露。

新写法（Hilt --- 编译时注入）

kotlin 复制代码

// 所有依赖关系在编译期确定，不会运行时找不到
@Module
@InstallIn(SingletonComponent::class)
object NetworkModule {
    @Provides @Singleton
    fun provideApi(retrofit: Retrofit): ApiService =
        retrofit.create(ApiService::class.java)
}

// 使用时 --- 编译期检查依赖是否可用
@AndroidEntryPoint
class MainActivity : AppCompatActivity() {
    @Inject lateinit var api: ApiService
}

一句话注意

编译时 DI（Hilt/Dagger）和运行时 DI（Koin/Service Locator）的核心区别：编译时 DI 的依赖图在构建阶段就校验好，依赖缺失直接编译报错；运行时 DI 直到执行时才发现问题。对大型项目来说，编译时报错 vs 线上崩溃是天壤之别。

Hilt 的代价是编译速度和配置复杂度，Koin 的代价是运行时风险和轻微性能损失。选哪个取决于项目规模和团队偏好------小型项目或需要快速迭代的阶段，Koin 够用；大型项目或对稳定性要求高的，选 Hilt。

Java Android 老项目迁移系列，持续更新中。