Spring Boot集成Naver邮件发送空指针异常排查求助

核心排查方向及步骤 #

• 检查EmailSenderService的容器注入状态
  空指针出现在调用EmailSenderService方法时，优先确认：

  • 该类是否添加了@Service或@Component注解，确保被Spring容器扫描并实例化
  • UserController中是否通过@Autowired或构造函数注入该服务，禁止手动new实例（手动实例化会脱离Spring管理，导致依赖无法注入）
  • 查看项目启动日志，确认EmailSenderService是否被成功初始化

• 核对邮件依赖完整性
  检查build.gradle中是否引入Spring Mail starter：

  implementation 'org.springframework.boot:spring-boot-starter-mail'
  

  缺失该依赖会导致邮件相关核心Bean无法初始化，间接引发空指针。

• 验证配置文件绑定有效性
  确认application.properties中的Naver邮箱配置是否正确绑定到JavaMailSender，参考标准配置：

  spring.mail.host=smtp.naver.com
  spring.mail.port=465
  spring.mail.username=你的Naver账号@naver.com
  spring.mail.password=Naver应用专用密码（非登录密码）
  spring.mail.properties.mail.smtp.auth=true
  spring.mail.properties.mail.smtp.ssl.enable=true
  spring.mail.properties.mail.smtp.starttls.enable=false
  

  检查EmailSenderService中是否正确注入JavaMailSender，若注入失败会导致发送方法调用时空指针。

• 定位第115行代码的具体空值
  若第115行是emailSenderService.sendMail(...)：

  • 除了服务实例本身为空，还要检查传入的收件地址、主题、内容等参数是否为空
  • 硬编码收件地址需确认格式合法（如xxx@naver.com）

• Naver邮箱权限验证
  确认Naver门户已开启SMTP服务，且使用的是应用专用密码（开启两步验证后必须使用专用密码，不能用账号登录密码）

调试建议 #

• 在UserController的doCheckMail方法中打印EmailSenderService实例的hashCode，确认是否为null
• 在EmailSenderService的发送方法入口添加日志，验证是否被正常调用
• 开启Spring debug日志，查看Bean初始化过程中是否有异常信息

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