Keycloak中部署自定义EmailSender SPI运行时触发NullPointerException

结合你提到的同一jar包中Federation Provider正常工作的情况，咱们一步步梳理可能的原因和解决办法：

• 检查/META-INF/services文件的准确性
  确保服务文件的文件名完全匹配EmailSenderProvider的全限定接口名，比如接口是com.yourcompany.spi.EmailSenderProvider，文件名就得一字不差，大小写、拼写都不能错。文件内容里的ProviderFactory全限定类名也要准确，不能有多余空格、换行或注释（如果只有一个实现的话）。

• 验证ProviderFactory的实现规范

  • 确认Factory类是public修饰，并且完整实现了对应的SPI Factory接口，没有遗漏抽象方法；
  • 检查Factory的实例化方法（比如create()）是否正确返回Provider实例——有没有在方法内部吞掉异常？比如实例化Provider时抛出了IO/配置异常但没处理，会导致返回null。可以临时在方法里加日志输出，或者直接返回一个硬编码的空实现测试；
  • 必须保证Factory类有无参构造函数，SPI机制默认通过反射调用无参构造来创建Factory实例，如果你只写了带参构造，会直接导致实例化失败。

• 排查类加载与打包问题

  • 虽然Federation Provider正常，但还是要确认EmailSender相关类是否被正确加载。可以给服务器加JVM启动参数-verbose:class，启动后搜索你的Provider/Factory类名，看是否有加载记录；
  • 解压jar包检查，确保Provider、Factory的class文件存在于正确的包路径下，没有被打包脚本遗漏。

• 对比Federation Provider的实现差异
  把你的EmailSender Provider/Factory和已正常工作的Federation Provider做对比：

  • 两者的Factory是否都用了无参构造？
  • 接口实现的方式有没有区别？比如Federation Provider有没有用特定注解、或者依赖了某些服务器内部的初始化逻辑？
  • 检查两者的类访问权限是否一致，有没有哪个类是package-private导致SPI无法访问？

• 深挖服务器日志
  很多时候SPI加载失败会在服务器日志里留下警告或错误信息，只是容易被忽略。搜索启动日志里的EmailSenderProvider、SPI、ProviderFactory关键词，找有没有异常堆栈——比如反射实例化失败的异常，这能直接定位问题根源。

• 尝试最小化实现测试
  写一个极简版的EmailSenderProvider（只实现必要的空方法）和对应的Factory（直接返回这个Provider实例），替换掉现有实现后部署测试。如果极简版能成功实例化，再逐步加回原有逻辑，就能排查出是哪部分代码导致的实例化失败。

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