Java初学者项目实战：构建基本的电子邮件客户端_网络技术

Java初学者应使用jakarta.mail替代已废弃的javax.mail，因JDK 9+模块化移除了java.activation，旧版会抛NoClassDefFoundError；需显式引入jakarta.mail-api和com.sun.mail:jakarta.mail依赖，并正确配置TLS/SSL、应用专用密码及Authenticator。

Java初学者直接写完整邮件客户端容易卡在认证、SSL、协议细节上，不建议从零手撸 SMTP/IMAP 协议栈。用 javax.mail（现为 jakarta.

mail）是合理起点，但要注意 JDK 11+ 默认不包含它，且旧版 javax.mail:mail 已废弃。

为什么 `javax.mail` 会抛 `NoClassDefFoundError` 或 `ClassNotFoundException`

因为 JDK 9 开始模块化，java.activation 和邮件 API 全被移出默认 classpath；JDK 11 彻底删除 java.activation 模块。即使加了旧 jar，也会因缺少 javax.activation.DataSource 等类失败。

✅ 正确做法：改用 jakarta.mail:jakarta.mail-api + com.sun.mail:jakarta.mail（推荐 2.0.1+）
❌ 不要再用 javax.mail:mail:1.6.2 或更老版本
若用 Maven，必须显式声明依赖，不能指望 JDK 自带


  jakarta.mail
  jakarta.mail-api
  2.1.3


  com.sun.mail
  jakarta.mail
  2.0.1

`Session.getInstance(...)` 和 `Session.getDefaultInstance(...)` 的区别与风险

后者已被标记为 @Deprecated，且线程不安全：多个线程调用会共享同一 Session 实例，导致配置（如密码、host）被覆盖。前者才是标准用法，但需传入 Properties 和可选的 Authenticator。

SMTP 发信必须设 mail.smtp.auth = "true"，否则 Gmail/Outlook 等拒绝连接
务必启用 TLS：mail.smtp.starttls.enable = "true"（Gmail 端口 587）或 SSL：mail.smtp.ssl.enable = "true"（端口 465）
避免硬编码密码——用 Authenticator 子类延迟提供凭据，防止日志泄露

Properties props = new Properties();
props.put("mail.smtp.host", "smtp.gmail.com");
props.put("mail.smtp.port", "587");
props.put("mail.smtp.auth", "true");
props.put("mail.smtp.starttls.enable", "true");

Session session = Session.getInstance(props, new Authenticator() {
  protected PasswordAuthentication getPasswordAuthentication() {
    return new PasswordAuthentication("user@gmail.com", "app-password-here");
  }
});

收邮件时 `Store.connect(...)` 报 `AuthenticationFailedException` 的常见原因

Gmail/Outlook 等已停用“用户名+密码”直连，必须用应用专用密码（App Password）或 OAuth2。普通网页登录密码无效，且开启两步验证后才可生成应用密码。

Gmail：进入 Google 账户 → 安全 → 两步验证 → 应用专用密码（选“邮件”，生成 16 位密码）
Outlook：账户安全设置 → 高级安全选项 → 应用密码
IMAP 设置必须匹配：Gmail 是 imap.gmail.com:993，mail.imaps.enable = "true"，且用 Store.connect(host, user, password)
别漏掉 folder.open(Folder.READ_ONLY)，否则 getMessages() 返回空数组

初学者最容易忽略的权限与安全细节

本地测试时，IDE 运行的 Java 进程可能被系统防火墙拦截出站连接；企业网络常屏蔽 465/587/993 端口；而 Gmail 对异常登录行为（如新设备、非浏览器 UA）会静默拒收或进垃圾箱。

发信后检查收件箱和垃圾邮件文件夹——Gmail 可能标记为“未加密发送”并降权
收信前先 telnet 测试端口连通性：telnet smtp.gmail.com 587（需安装 telnet 客户端）
不要在代码里写死邮箱密码，哪怕只是 demo；至少用 System.console().readPassword() 交互输入
收到 javax.mail.AuthenticationFailedException: 535-5.7.8 Username and Password not accepted 时，90% 是密码错或未开应用专用密码

真正跑通收发，关键不在写多少行代码，而在确认每层协议（DNS 解析、TCP 连接、TLS 握手、SMTP/IMAP 认证）是否逐级通过。卡住时优先查网络和账号设置，而不是重写 Java 逻辑。

# word # java # go # 编码 # 防火墙 # 浏览器 # app # 端口 # ssl # session # 栈 # ai # outlook # dns # maven # 子类

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】