Java开发邮件应用时javax.mail相关包导入失败如何解决

问题根源 #

Java EE 6 内置的 JavaMail 版本严重过时，且 JDK 8 及更高版本已默认移除 javax.activation 等关联包，仅添加 Java EE 6 JARs 无法适配当前主流运行环境，因此会持续出现导包报错。 #

解决方案 #

方案一：通过构建工具引入依赖（推荐） #

Maven 项目

在 pom.xml 的 dependencies 节点中添加以下坐标：

<dependency>
    <groupId>com.sun.mail</groupId>
    <artifactId>javax.mail</artifactId>
    <version>1.6.2</version>
</dependency>

Gradle 项目

在 build.gradle 的 dependencies 代码块中添加以下配置：

implementation 'com.sun.mail:javax.mail:1.6.2'

配置完成后点击 IntelliJ 侧边栏 Maven/Gradle 面板的刷新按钮，等待依赖同步完成即可。 #

方案二：手动导入 Jar 包 #

如果不使用项目构建工具，按以下步骤操作：

• 下载官方最新版 javax.mail.jar 和 activation.jar 安装包
• 打开 IntelliJ 顶部菜单栏 File > Project Structure > Modules > Dependencies
• 点击依赖列表上方的 + 号，选择 JARs or directories，选中下载的两个 Jar 包添加
• 勾选新增的两个依赖前的复选框，点击 Apply 保存配置

异常排查 #

如果配置完成后仍有报错：

• 执行顶部菜单栏 File > Invalidate Caches... 清除缓存并重启 IntelliJ
• 检查项目的 SDK 版本是否和依赖兼容，JDK 8 及以上版本搭配 1.6.x 版本的 JavaMail 依赖即可正常运行
• 确认导入语句的拼写正确：

  import javax.mail.*;
  import javax.mail.internet.*;
  import javax.activation.*;
  

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