Go genetlink 家族版本与协议版本有什么区别

使用 Go 的 genetlink 时，“家族版本”和“协议版本”不是同一个数字。最容易混淆的地方是：genetlink.Protocol 表示底层 socket 要使用的 generic netlink 协议号；genetlink.Family.Version 则来自目标家族的发现结果，应该写入具体命令的 genetlink.Header.Version。前者决定走哪类 netlink 通道，后者描述目标家族如何理解这条命令。

官方地址：https://pkg.go.dev/github.com/mdlayher/genetlink

先把三个容易混淆的字段分开

这三个字段位于不同层次。Protocol 是连接层选择，Family.ID 是目标 family 的标识，Header.Version 是当前命令头里的版本。它们可能同时出现在同一段代码中，但职责并不相同。

genetlink.Protocol 是协议入口，不是家族版本

包文档把 Protocol 定义为 generic netlink 使用的 netlink 协议常量。它的作用是告诉底层连接选择 generic netlink 这一类通道，回答的是“通过哪种协议通信”，而不是“某个家族的命令接口版本是多少”。

大多数应用不需要手动把这个常量塞进业务消息。调用 genetlink.Dial(nil) 时，包会为 generic netlink 建立连接；如果需要自定义底层 netlink.Config，仍然是在连接层配置，不应把它当作目标 family 的版本协商。

package main

import (
    "errors"
    "fmt"
    "log"
    "os"

    "github.com/mdlayher/genetlink"
)

func openFamily(name string) (*genetlink.Conn, genetlink.Family, error) {
    // Dial 选择 generic netlink 连接；这里的协议层选择不是 family 版本。
    conn, err := genetlink.Dial(nil)
    if err != nil {
        return nil, genetlink.Family{}, err
    }

    family, err := conn.GetFamily(name)
    if err != nil {
        // 发现失败时关闭已经建立的连接，避免把资源交给调用方后再泄漏。
        _ = conn.Close()
        if errors.Is(err, os.ErrNotExist) {
            return nil, genetlink.Family{}, fmt.Errorf("family %q 不存在: %w", name, err)
        }
        return nil, genetlink.Family{}, err
    }
    log.Printf("family=%s id=%d version=%d", family.Name, family.ID, family.Version)
    return conn, family, nil
}

上面的示例强调连接与 family 发现的边界。若要直接编译，还需要在 import 中加入 fmt；这里故意把资源关闭和错误分支写清楚，实际项目不要用日志输出替代错误处理。

Family.Version 才是目标家族的版本信息

genetlink.Family 包含 ID、Version、Name 和组播组列表。调用 GetFamily 查询 family 后，返回的 Version 是与该 family 关联的版本值。它不是所有 family 共用的 global version，也不是底层 socket 的协议号。

家族发现结果通常还会带回 family ID。发送消息时必须同时使用正确的 family ID 和版本字段：ID 负责路由到目标 family，版本放在 generic netlink 消息头中，供目标 family 按自己的接口语义解释。

构造请求时把 Family.Version 放进 Header.Version

以 nl80211 这类 generic netlink family 为例，先用 GetFamily 获取 family，再将 family.Version 放进 genetlink.Header.Version。命令号、属性号仍然来自对应 Linux 内核 UAPI；它们不是由 Go 包自动推断出来的。

package main

import (
    "errors"
    "fmt"
    "os"

    "github.com/mdlayher/genetlink"
    "github.com/mdlayher/netlink"
)

func makeRequest(conn *genetlink.Conn, familyName string, command uint8) (genetlink.Family, []genetlink.Message, error) {
    // 先发现目标 family，不能把 Protocol 或自行猜测的数字当作 family ID。
    family, err := conn.GetFamily(familyName)
    if err != nil {
        if errors.Is(err, os.ErrNotExist) {
            return genetlink.Family{}, nil, fmt.Errorf("未找到 family %q: %w", familyName, err)
        }
        return genetlink.Family{}, nil, err
    }

    request := genetlink.Message{
        Header: genetlink.Header{
            Command: command,
            // 命令版本来自目标 family 的发现结果。
            Version: family.Version,
        },
    }

    // family.ID 负责把请求发送给正确的 family，Request|Dump 只表达请求语义。
    replies, err := conn.Execute(request, family.ID, netlink.Request|netlink.Dump)
    if err != nil {
        return family, nil, err
    }
    return family, replies, nil
}

这里的关键不是“永远把某个固定数字写进 Version”，而是先发现目标 family，再沿着同一份结果构造请求。不同 family 的命令和属性定义不能互换；即便两个 family 恰好返回相同版本数字，也不代表它们的命令可以通用。

为什么不能把协议版本、Family.ID 和 Header.Version 混用

混用时常见的错误有三种。第一，把 genetlink.Protocol 当成 Header.Version；这样语义上把连接层常量误放进 family 命令头。第二，把 Family.ID 当成版本；ID 是内核运行时分配或发现到的目标编号，不能代表接口版本。第三，把某个示例里的固定版本数复制到另一 family；这会把一个 family 的约定带到不相关的命令上。

如果服务端拒绝请求，排查顺序应从目标 family、命令号、属性编码和权限入手，再看版本是否来自正确的发现结果。不要只看到一个“版本不匹配”的现象，就尝试把 Protocol、Family.ID 和 Header.Version 逐个替换成同一个数字。

按使用场景选择正确的检查方式

常见问题

genetlink.Protocol 就是协议版本吗？

它是 generic netlink 使用的 netlink 协议常量，属于连接协议选择；文章标题中的“家族版本”通常指 Family.Version，两者不是同一层的版本。

Family.Version 是否可以直接写成 1？

不能把 1 当成通用答案。只有在目标 family 的 UAPI 明确规定该命令版本并且你的兼容策略允许固定值时才这样做；优先使用发现结果。

Family.ID 变化了是不是协议版本变了？

不一定。ID 用于当前内核中定位 family，版本字段描述 family 接口。二者需要分别记录和传递。

为什么示例代码有时没有显式设置 Header.Version？

有些高层调用只做 family 发现，或示例没有展示具体命令；一旦手动构造 genetlink.Message，就应按照目标 family 的约定设置头部版本。