Go net/mail.Header.AddressList 缺少 From 字段时怎样区分空值与错误

用 Go 解析邮件头时，Header.AddressList("From") 返回 mail: header not in message，通常不是解析器坏了，而是输入里没有可用的 From 头。处理这类结果要把“字段缺失”“字段存在但为空”和“地址格式损坏”分开：前两种可以按业务策略继续，真正的语法错误则应保留并记录。

官方文档：https://pkg.go.dev/net/mail#Header.AddressList

先确认 AddressList 返回值的三种状态

Header.AddressList 会读取指定头字段，并尝试把它解析成 []*mail.Address。它的关键不是“有没有返回切片”，而是返回值和错误的组合。缺少字段时，错误是公开的 mail.ErrHeaderNotPresent；字段存在但值为空时，仍要按输入内容判断；地址语法不合法时，则会返回另一类解析错误。

用 errors.Is 处理缺少 From 的邮件头

不要用错误字符串判断，也不要把所有错误都当成“没有 From”。标准库提供了可比较的哨兵错误，使用 errors.Is 能兼容被包装过的错误，并为真正的格式错误留下单独分支。

package main

import (
    "errors"
    "fmt"
    "net/mail"
)

func readFrom(h mail.Header) ([]*mail.Address, error) {
    addresses, err := h.AddressList("From")
    if err != nil {
        // 缺少 From 可能是业务允许的可选字段，不能和坏地址混在一起。
        if errors.Is(err, mail.ErrHeaderNotPresent) {
            return nil, fmt.Errorf("from header missing: %w", err)
        }
        // 其他错误保留原始原因，交给上层决定拒绝还是隔离。
        return nil, fmt.Errorf("from header parse failed: %w", err)
    }
    // 没有错误也不能默认存在有效地址，先检查切片长度。
    if len(addresses) == 0 {
        return nil, errors.New("from header has no address")
    }
    return addresses, nil
}

上层如果需要区分策略，可以再次用 errors.Is(err, mail.ErrHeaderNotPresent) 判断“缺失”，而不是匹配 err.Error()。如果 From 是协议必填项，就把缺失分支标记为拒绝；如果只是展示信息，则可以继续读取 Subject 或正文。

区分空值、空列表与坏地址

邮件头是外部输入，常见的误区是收到错误后仍然假设切片里有一项，例如直接读取 addresses[0].Address。安全顺序应该是：先处理错误，再检查切片长度，最后读取每个地址对象。

func classifyFrom(h mail.Header) string {
    addresses, err := h.AddressList("From")
    if errors.Is(err, mail.ErrHeaderNotPresent) {
        // 键不存在：这是 missing，不等于空字符串。
        return "missing"
    }
    if err != nil {
        // 有值但格式不符合地址语法：记录 parse-error。
        return "parse-error"
    }
    if len(addresses) == 0 {
        // 解析成功但没有可用地址，单独处理空值边界。
        return "empty-value"
    }
    return "valid"
}

实际导入时，建议保留头字段名和分类结果，但不要把整封邮件内容写进普通日志。对地址解析失败的记录，可以保存脱敏后的消息标识、字段名和错误类型，方便重放单条样本。

把结果接入导入日志与检查清单

一套够用的判断清单如下：

• 先确认 Header 来自完整的 mail.ReadMessage 结果，而不是只截取了邮件头或把正文当头部。
• 缺少 From 时用 errors.Is 匹配 mail.ErrHeaderNotPresent。
• 地址字段存在时，不跳过非哨兵错误；它可能表示坏引号、非法地址或不支持的格式。
• 读取地址前检查 len(addresses)，需要所有收件人时遍历切片，不要只拿第一项。

Header.Get("From") 只适合取第一个原始头值，并且取不到字段时返回空字符串；它不能告诉你是字段缺失、字段为空，还是值本身无法按地址语法解析。因此，涉及导入校验时应优先使用 AddressList。

相关问题

缺少 From 时能不能直接忽略错误？

只有在业务允许无发件人的场景才可以。忽略前先用 errors.Is 确认是 ErrHeaderNotPresent，不要吞掉其他解析错误。

为什么 Header.Get("From") 返回空字符串？

它既可能表示字段不存在，也可能表示字段值为空；如果需要区分原因，应改用 AddressList。

AddressList 返回多个地址时该怎么处理？

遍历完整切片并分别校验；只有业务明确要求单一发件人时，才把多地址作为独立的业务错误。