HK2 并非自动扫描并注册所有 @Contract/@Service 标注类，必须显式初始化 ServiceLocator 并注册服务，否则 @Inject 将因依赖未绑定而失败。
hk2 并非自动扫描并注册所有 `@contract`/`@service` 标注类，必须显式初始化 servicelocator 并注册服务，否则 `@inject` 将因依赖未绑定而失败。
在使用 HK2 进行依赖注入时，一个常见误区是认为只要为接口标注 @Contract、为实现类标注 @Service，HK2 就会自动发现并绑定服务——事实并非如此。HK2 是一个显式、轻量且延迟加载的依赖注入框架，它不会主动扫描类路径或注解，也不会在 new 实例时自动解析 @Inject 字段。若跳过服务定位器（ServiceLocator）的创建与服务注册步骤，@Inject 将始终失败，并抛出类似 UnsatisfiedDependencyException 或 ServiceNotFoundException 的错误。
✅ 正确使用 HK2 的三步核心流程
- 确保所有可被注入的组件都声明为 HK2 服务（即标注 @Service）；
- 通过 ServiceLocator 显式注册服务类（支持自动扫描或手动添加）；
- 始终从 ServiceLocator 获取实例，而非使用 new 创建。
以下为修正后的完整示例：
✅ 步骤 1：标注所有参与注入的类为 @Service
@Contract
public interface IUserService {
List<User> getAllUsers();
}
@Service // ✅ 必须标注，否则 HK2 不识别为可提供服务
public class UserService implements IUserService {
@Override
public List<User> getAllUsers() {
return List.of(new User(), new User(), new User());
}
}
@Service // ✅ UserResource 本身也需是 HK2 服务，才能启用字段注入
public class UserResource {
@Inject // ✅ 现在有效：IUserService 已注册，且 locator 负责注入
private IUserService service;
public List<User> getAllUsers() {
return service.getAllUsers();
}
}✅ 步骤 2：在启动入口中创建并初始化 ServiceLocator
public class App {
public static void main(String[] args) {
// 1️⃣ 创建 ServiceLocator 实例（命名唯一，便于调试）
ServiceLocator locator = ServiceLocatorFactory.getInstance()
.create("myAppLocator");
// 2️⃣ 注册服务类（推荐方式：自动发现 + 手动补充）
ServiceLocatorUtilities.addClasses(locator,
UserService.class, // 实现类
UserResource.class // 使用方（也是服务）
);
// 3️⃣ ✅ 从 locator 获取实例 —— 此时 @Inject 才会被处理
UserResource resource = locator.getService(UserResource.class);
System.out.println(resource.getAllUsers().size()); // 输出: 3
}
}⚠️ 注意事项：
- ServiceLocatorUtilities.addClasses(...) 依赖 hk2-metadata-generator 在编译期生成 META-INF/hk2-locator/default 元数据文件。请确保构建时启用了注解处理器（Maven 中需配置 annotationProcessorPaths 或启用 maven-compiler-plugin 的 annotationProcessing）。
- 若跳过 @Service 标注 UserResource，即使 UserService 已注册，new UserResource() 也无法触发注入——因为 @Inject 仅在 HK2 管理的实例中生效。
- 不要混合使用 new 和 @Inject：new UserResource() 绕过了 HK2 生命周期，其 service 字段将保持 null。
? 替代方案：启用自动服务发现（推荐用于模块化项目）
若项目结构清晰，可借助 ServiceLocatorUtilities.bind() 或 DynamicConfigurationService 实现更灵活的绑定，但对初学者而言，addClasses() 是最直观可靠的起点。
✅ 总结
| 错误做法 | 正确做法 |
|---|---|
| new UserResource() | locator.getService(UserResource.class) |
| 仅 @Service 实现类 | 所有被注入/注入他人的类均需 @Service |
| 忽略 ServiceLocator 初始化 | 显式创建 + addClasses() / bind() 注册 |
HK2 的设计哲学是“显式优于隐式”——它赋予开发者完全控制权，但也要求你承担服务生命周期管理的责任。理解并遵循这一原则，是解锁 HK2 强大能力的前提。
