# Jenkins 邮件通知检查清单

## 问题：邮件没有触发

### 检查清单

#### 1. 检查 Jenkins 邮件配置
访问：`http://localhost:8084/configure`

**Extended E-mail Notification 配置：**
- [ ] SMTP server 已配置（如：smtp.qq.com）
- [ ] SMTP port 已配置（如：465）
- [ ] Use SMTP Authentication 已勾选
- [ ] User Name 已填写（完整邮箱地址）
- [ ] Password 已填写（授权码，不是邮箱密码）
- [ ] Use SSL 已勾选
- [ ] Default Recipients 已填写或 Jenkinsfile 中指定了收件人

**测试配置：**
- [ ] 点击 "Test configuration by sending test e-mail"
- [ ] 输入测试邮箱：ldl@chzu.edu.cn
- [ ] 点击 "Test configuration"
- [ ] 检查是否收到测试邮件

#### 2. 检查 Jenkinsfile 配置
- [ ] `to: 'ldl@chzu.edu.cn'` 已正确配置
- [ ] `emailext` 在 `post` 部分
- [ ] `post { success { ... } }` 配置正确

#### 3. 检查构建状态
邮件只在以下情况发送：
- [ ] **success** - 构建成功
- [ ] **failure** - 构建失败
- [ ] **unstable** - 构建不稳定（测试失败但继续）

**查看构建状态：**
```
访问：http://localhost:8084/job/slms/lastBuild/
查看：构建结果（SUCCESS/FAILURE/UNSTABLE）
```

#### 4. 检查 Jenkins 日志
访问：`http://localhost:8084/job/slms/lastBuild/console`

**搜索关键词：**
```
发送成功通知邮件
准备发送邮件到
成功通知邮件已发送
邮件发送失败
```

**如果看到错误：**
```
javax.mail.AuthenticationFailedException
```
→ 检查 SMTP 用户名和密码（授权码）

```
javax.mail.MessagingException: Could not connect to SMTP host
```
→ 检查 SMTP 服务器地址和端口

```
com.sun.mail.smtp.SMTPSendFailedException: 550 Invalid User
```
→ 检查收件人邮箱地址是否正确

#### 5. 检查邮箱设置

**QQ 邮箱：**
- [ ] 已开启 SMTP 服务
- [ ] 已生成授权码
- [ ] 授权码正确填写到 Jenkins

**163 邮箱：**
- [ ] 已开启 IMAP/SMTP 服务
- [ ] 已设置客户端授权密码

**企业邮箱：**
- [ ] 联系管理员确认 SMTP 配置
- [ ] 确认是否需要白名单

#### 6. 检查防火墙和网络
- [ ] Jenkins 服务器可以访问 SMTP 服务器
- [ ] SMTP 端口（465/587）未被防火墙阻止

**测试连接：**
```bash
# Windows
telnet smtp.qq.com 465

# 或使用 PowerShell
Test-NetConnection -ComputerName smtp.qq.com -Port 465
```

#### 7. 检查邮件插件
访问：`http://localhost:8084/pluginManager/installed`

**必需插件：**
- [ ] Email Extension Plugin (已安装且已启用)
- [ ] Mailer Plugin (已安装且已启用)

#### 8. 手动触发测试

**方法 1：在 Jenkins Script Console 测试**
访问：`http://localhost:8084/script`

```groovy
import javax.mail.*
import javax.mail.internet.*

def props = new Properties()
props.put("mail.smtp.host", "smtp.qq.com")
props.put("mail.smtp.port", "465")
props.put("mail.smtp.auth", "true")
props.put("mail.smtp.ssl.enable", "true")

def session = Session.getInstance(props, new Authenticator() {
    protected PasswordAuthentication getPasswordAuthentication() {
        return new PasswordAuthentication("your-email@qq.com", "your-auth-code")
    }
})

def message = new MimeMessage(session)
message.setFrom(new InternetAddress("your-email@qq.com"))
message.addRecipient(Message.RecipientType.TO, new InternetAddress("ldl@chzu.edu.cn"))
message.setSubject("Jenkins 邮件测试")
message.setText("这是一封测试邮件")

Transport.send(message)
println "邮件发送成功！"
```

**方法 2：触发一次构建**
```bash
# 推送代码触发构建
git commit --allow-empty -m "test: 触发邮件测试"
git push
```

## 常见问题解决

### 问题 1: 收不到邮件但日志显示发送成功
**可能原因：**
- 邮件进入垃圾箱
- 邮箱服务器延迟

**解决方案：**
1. 检查垃圾邮件文件夹
2. 将 Jenkins 邮箱加入白名单
3. 等待几分钟再检查

### 问题 2: 授权码认证失败
**可能原因：**
- 授权码输入错误
- 授权码已过期
- 未开启 SMTP 服务

**解决方案：**
1. 重新生成授权码
2. 确认 SMTP 服务已开启
3. 复制粘贴授权码，避免手动输入错误

### 问题 3: 连接超时
**可能原因：**
- 防火墙阻止
- SMTP 端口错误
- 网络问题

**解决方案：**
1. 检查防火墙设置
2. 确认端口：QQ/163 使用 465（SSL）或 587（TLS）
3. 测试网络连接

### 问题 4: 邮件内容乱码
**可能原因：**
- 字符集配置错误

**解决方案：**
在 Jenkins 配置中设置：
- Default Content Type: `text/html; charset=UTF-8`
- Charset: `UTF-8`

## 验证邮件功能

### 成功标志
- [ ] Jenkins 日志显示：`✓ 成功通知邮件已发送到: ldl@chzu.edu.cn`
- [ ] 收件箱收到邮件
- [ ] 邮件内容完整，链接可点击
- [ ] 邮件格式正确（HTML）

### 邮件内容应包含
- [ ] 构建编号
- [ ] 构建时间
- [ ] Git 提交信息
- [ ] 构建结果列表
- [ ] Jenkins 制品下载链接
- [ ] 头歌 Release 分支链接
- [ ] SonarQube 报告链接

## 当前配置

**收件人：** ldl@chzu.edu.cn

**邮件类型：**
1. ✅ 成功邮件 - 构建成功时发送
2. ❌ 失败邮件 - 构建失败时发送
3. ⚠️ 不稳定邮件 - 测试失败但继续时发送

**触发条件：**
- 每次构建完成后自动发送
- 根据构建结果选择邮件类型

## 下一步

如果以上都检查完毕仍然收不到邮件：

1. 查看 Jenkins 系统日志
   - 访问：`http://localhost:8084/log/all`
   - 搜索：`mail` 或 `email`

2. 启用调试日志
   - 访问：`http://localhost:8084/log/`
   - 添加新的 Logger：`hudson.plugins.emailext`
   - 级别：`ALL`

3. 联系邮箱服务提供商
   - 确认 SMTP 服务状态
   - 检查是否有发送限制

4. 尝试其他邮箱
   - 使用 Gmail 或 163 邮箱测试
   - 排除特定邮箱的问题