升级Play 2.5.12至2.5.18启动时遇CreationException注入器创建失败错误

首先咱们先拆解下错误信息的核心：

CreationException: Unable to create injector, see the following errors:

1. Error injecting constructor, java.lang.NullPointerException at modules.OnStart.(OnStart.java:15)
   at modules.Global.configure(Global.java:9) (via modules: com.google.inject.util.Modules$OverrideModule -> modules.Global)
   while locating modules.OnStart
   1 error

这个报错说明Guice在创建OnStart类实例时，它的构造函数第15行触发了空指针异常，而OnStart是通过你的Global模块第9行的配置绑定的。下面是具体的排查和修复步骤：

1. 先定位OnStart.java第15行的空指针来源 #

打开OnStart.java直接看第15行代码，确认是哪个对象为null：

• 如果你的OnStart是通过构造函数接收依赖注入（比如传入其他服务类），那大概率是这个依赖没被Guice正确绑定，导致注入时拿到了null；
• 如果是你在构造函数里自己初始化对象时出了问题（比如调用了一个返回null的方法），那就要检查这段初始化逻辑。

举个常见的错误场景：

// OnStart.java
public class OnStart {
    private final UserService userService;

    // 构造函数注入依赖
    public OnStart(UserService userService) {
        this.userService = userService;
        userService.init(); // 第15行，如果userService为null就会抛出NPE
    }
}

这里的问题就是UserService没有被Guice正确绑定，导致注入失败。

2. 检查Global.java第9行的绑定配置 #

打开Global.java看第9行的configure方法，确认OnStart的绑定方式是否正确：

• 如果你用的是bind(OnStart.class).asEagerSingleton()：这种写法是合理的（因为OnStart通常是启动时执行的逻辑，需要饿汉单例），但要确保它的所有依赖都能被Guice找到；
• 如果你是手动实例化OnStart（比如bind(OnStart.class).toInstance(new OnStart())）：这种写法会跳过Guice的依赖注入，构造函数里的依赖肯定会是null，必须改成让Guice管理实例的绑定方式。

3. 适配Play 2.5.x小版本的Guice变化 #

Play 2.5.18相比2.5.12升级了Guice版本（从4.0升到4.1.0），一些旧的绑定逻辑可能不再兼容：

• 确保所有需要注入的类，若有多个构造函数，必须给要用来注入的那个加@Inject注解（如果只有一个公共构造函数，Guice会自动识别）；
• 避免在构造函数里执行复杂初始化逻辑（比如调用外部服务、访问数据库），这些逻辑应该放到@PostConstruct注解的方法里，确保所有依赖都注入完成后再执行；
• 自定义服务要显式绑定接口与实现类，不要依赖Guice的隐式绑定（小版本升级后可能调整了隐式绑定的规则）。

4. 修复示例 #

假设你的问题是UserService没有绑定，那在Global.java的configure方法里补充绑定：

// Global.java
public class Global extends AbstractModule {
    @Override
    protected void configure() {
        bind(UserService.class).to(UserServiceImpl.class); // 绑定接口到具体实现类
        bind(OnStart.class).asEagerSingleton(); // 第9行的原有绑定
    }
}

如果是构造函数里的初始化逻辑导致的问题，改成用@PostConstruct延迟执行：

// OnStart.java
public class OnStart {
    private final UserService userService;

    @Inject
    public OnStart(UserService userService) {
        this.userService = userService;
    }

    @PostConstruct
    public void onApplicationStart() {
        userService.init(); // 此时userService已被正确注入，不会出现NPE
    }
}

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