HK2 并非自动扫描并注册所有带 @Contract/@Service 注解的类，必须显式初始化 ServiceLocator 并注册服务，否则 @Inject 将因依赖未绑定而失败。
hk2 并非自动扫描并注册所有带 `@contract`/`@service` 注解的类，必须显式初始化 `servicelocator` 并注册服务，否则 `@inject` 将因依赖未绑定而失败。
在使用 HK2 进行依赖注入时，一个常见误区是认为只要为接口标注 @Contract、为实现类标注 @Service，再配合 @Inject 就能自动完成注入——这并不成立。HK2 是一个显式、轻量且延迟初始化的依赖注入容器，它不会主动扫描类路径或自动注册服务，所有可注入组件都必须通过 ServiceLocator 显式声明或由元数据生成器自动发现并加载。
✅ 正确配置的关键步骤
-
确保注解使用规范
- 接口需用 org.jvnet.hk2.annotations.Contract（而非自定义或 Jakarta 注解）；
- 实现类需用 org.jvnet.hk2.annotations.Service；
- 所有需要被注入的类（如 UserResource）也必须是 HK2 管理的服务（即标注 @Service），否则其内部 @Inject 字段将被忽略。
启用注解处理器（推荐）
添加 hk2-metadata-generator 后，需在构建插件中启用注解处理（Maven 示例）：
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.11.0</version>
<configuration>
<annotationProcessorPaths>
<path>
<groupId>org.glassfish.hk2</groupId>
<artifactId>hk2-metadata-generator</artifactId>
<version>3.0.4</version>
</path>
</annotationProcessorPaths>
</configuration>
</plugin>该插件会在编译期生成 META-INF/hk2-locator/default 元数据文件，使 ServiceLocatorUtilities.bind() 能自动识别服务。
-
正确初始化 ServiceLocator 并获取实例
❌ 错误做法：手动 new UserResource() → 绕过 HK2 容器，@Inject 完全不生效；
✅ 正确做法：通过 ServiceLocator 获取服务实例，触发依赖解析与注入：
public class App {
public static void main(String[] args) {
// 创建 ServiceLocator 实例
ServiceLocator locator = ServiceLocatorFactory.getInstance()
.create("myAppLocator");
// 方式一：自动加载 META-INF/hk2-locator/default 中的元数据（推荐）
ServiceLocatorUtilities.enableAutoDiscovery(locator);
// 方式二：手动注册（适用于无元数据或调试场景）
// ServiceLocatorUtilities.addClasses(locator,
// UserService.class,
// UserResource.class
// );
// 从容器中获取服务（此时 @Inject 已完成注入）
UserResource resource = locator.getService(UserResource.class);
System.out.println(resource.getAllUsers());
}
}? 提示：enableAutoDiscovery() 会扫描类路径下所有 META-INF/hk2-locator/ 下的元数据文件，是生产环境首选；addClasses() 更适合单元测试或快速验证。
⚠️ 常见陷阱与注意事项
- 依赖版本一致性：确保 hk2-api、hk2-utils、hk2-metadata-generator 使用相同主版本（如 3.0.x），避免 ClassCastException 或元数据不兼容；
- @Inject 来源：务必使用 jakarta.inject.Inject（Jakarta EE 9+），而非 javax.inject.Inject（已弃用）；
- 字段访问权限：HK2 默认支持 private 字段注入，无需 setter 或构造器注入（但构造器注入更利于测试）；
- 生命周期管理：@Service 默认为 SINGLETON，如需原型作用域，需显式添加 @Scope(PerLookup.class)。
✅ 最终修正后的完整代码结构
// 接口（Contract）
@Contract
public interface IUserService {
List<User> getAllUsers();
}
// 实现（Service）
@Service
public class UserService implements IUserService {
@Override
public List<User> getAllUsers() {
return List.of(new User(), new User(), new User());
}
}
// 资源类（也必须是 Service）
@Service
public class UserResource {
@Inject
private IUserService service; // ✅ 将被 HK2 自动注入
public List<User> getAllUsers() {
return service.getAllUsers();
}
}遵循以上配置，即可彻底解决 “@Inject 不生效” 的问题。核心原则始终如一：HK2 只注入它知道的服务，而它只通过 ServiceLocator 知道你告诉它的那些服务。
