Go goquery 选择结果为空时调用 Attr 和 Eq 会怎样

Go goquery 的有效空选择集调用 Attr 会返回空字符串和 false；调用 Eq，不论使用 0、-1 还是其他越界下标，都会得到一个新的空选择集，不会仅因没有匹配节点就 panic。这里的“空选择集”不是 nil 指针，也不能把这个结论推广到 Get 或直接访问 Nodes。

官方地址：https://github.com/PuerkitoBio/goquery

提取任务遇到空值，先分清三种状态

假设一个内部 HTML 提取任务读取商品的 data-sku。某个样本没有商品节点，另一个节点有 data-sku 却没有值。如果只判断 value == ""，日志会把两种问题合并成“编号为空”，后续排查不知道应改选择器还是补数据。

Attr 的布尔值表示首个节点是否存在指定属性，而不是字符串是否非空。它不搜索后续节点来替第一个节点补值。上述返回规则依据官方 属性方法实现；表格是语义说明，不是执行日志。

用内存HTML固定边界样本

把案例放在一个 Go module 的 main.go 中，并在模块里添加 goquery 依赖。示例只解析字符串，不需要网络访问权限、网站账号或页面下载流程。先固定样本，再把同样的处理函数接入已有任务；不要用线上页面的偶然变化解释库行为。

package main

import (
    "fmt"
    "strings"

    "github.com/PuerkitoBio/goquery"
)

// 必填字段：区分无节点、无属性、空业务值。
func requiredSKU(s *goquery.Selection) (string, error) {
    if s == nil {
        return "", fmt.Errorf("选择集未初始化")
    }
    if s.Length() == 0 {
        return "", fmt.Errorf("未命中商品节点")
    }
    value, exists := s.Attr("data-sku")
    if !exists {
        return "", fmt.Errorf("首个节点缺少 data-sku")
    }
    if strings.TrimSpace(value) == "" {
        return "", fmt.Errorf("data-sku 不能为空")
    }
    return value, nil
}

func main() {
    // 使用固定HTML样本，不请求网站。
    doc, err := goquery.NewDocumentFromReader(strings.NewReader(
        `


`))
    if err != nil {
        panic(err)
    }
    for _, selector := range []string{"#absent", "#missing", "#blank", "#good"} {
        s := doc.Find(selector)
        value, exists := s.Attr("data-sku")
        fmt.Printf("%s: len=%d value=%q exists=%t\\n",
            selector, s.Length(), value, exists)
        sku, err := requiredSKU(s)
        fmt.Printf("业务结果 sku=%q err=%v\\n", sku, err)
    }
    empty := doc.Find("#absent")
    // 越界Eq仍是有效空选择集，可以继续调用Attr。
    for _, index := range []int{0, -1, 9} {
        s := empty.Eq(index)
        value, exists := s.Attr("data-sku")
        fmt.Printf("Eq(%d): len=%d value=%q exists=%t\\n",
            index, s.Length(), value, exists)
    }
}

按照方法语义，#absent 与 #missing 的 exists 都是 false，#blank 的 exists 是 true，#good 的值为 A17。三个空集 Eq 样本仍然 Length 为 0。这里没有声称运行过代码，也没有把推导结果包装成实测输出。

把必填字段缺失变成明确错误

requiredSKU 先处理接收者未初始化，再处理无节点，最后区分属性缺失与空内容。库允许空选择集继续调用方法，不代表业务必填字段可以默默通过。反过来，如果字段确实可选，可以返回空值或使用 AttrOr 的默认值，不必人为制造错误。

Eq 对负数下标按集合末尾计算，-1 表示最后一个节点；下标无效则返回空集。这只保证选取动作的边界行为，不保证业务上“必须有第一个元素”。Get 的实现直接访问节点切片，越界会 panic；Slice 也不提供 Eq 那样的完整越界保护。具体依据官方 索引方法实现。

nil 指针属于另外一个问题：Attr 和 Eq 都要访问接收者字段，不能把 nil 当成查询未命中。用 doc.Find 得到的有效空集与声明后未赋值的 *goquery.Selection 应明确区分。不要以 recover 替代这个入口判断。

失败记录只保存必要上下文

接入自动任务时，阶段可拆为解析、选择、字段读取、业务接收。记录样本标识、选择器、匹配数量和字段状态即可定位多数缺失问题。必填字段失败时停止这一条记录的接收，并交给现有错误汇总；可选字段缺失不需要每次独立通知。不要把整份可能含敏感信息的 HTML 放进报警，也不应因为一次未命中就盲目重复网络请求。

排查顺序是：确认输入内容是否正确，再确认选择器是否适合该样本，最后检查属性名及业务空值规则。保持失败原因可区分，比把所有缺失都变成空字符串更有用。

空选择集可以链式调用 Eq(0).Attr 吗？

可以，在有效选择集上 Eq 越界得到空集，后续 Attr 返回空串和 false；必填字段仍需调用方判定。

AttrOr 会替换已有的空属性值吗？

不会。属性存在即返回原值，哪怕它为空串；默认值仅用于属性不存在的情况。

Eq(-1) 会在空集合上选到一个节点吗？

不会。空集合没有最后一个节点，结果仍为空集。

Get(0) 和 Eq(0) 能互换吗？

不能。Get 返回底层节点并直接索引切片，空集合调用会越界；Eq 返回选择集并处理无效下标。

总结：Length 判断是否命中，Attr 的布尔值判断属性是否存在，业务规则判断字符串能否为空。把这三层拆开，空集行为就不会再掩盖数据错误。