Go genetlink 家族编号为什么不宜硬编码

在 Go 中使用 github.com/mdlayher/genetlink 时，Family.ID 应该被看成“当前连接查询得到的地址”，而不是可以写进配置文件的协议常量。更稳妥的做法是用 family name 作为查找入口，连接建立后调用 GetFamily，再在这条连接的生命周期内使用返回的 ID 和 Version。

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

不要把某次机器上看到的 generic netlink 家族编号复制成全局常量。名称用于发现，编号用于当前连接中的请求；如果连接重建或运行环境变化，就重新发现。

症状：同一段请求换环境后突然找不到目标家族

问题通常不是请求结构本身，而是代码把类似 familyID = 32 的数字当成了永久标识。generic netlink 家族通过名称注册，应用查询后才拿到一个 uint16 类型的 ID。这个 ID 能用于后续消息寻址，但它的意义依附于当前系统的注册状态和当前连接，不适合脱离发现过程长期保存。

在 genetlink 包的 Family 结构中，ID、Version、Name 和多播组信息是同一次发现得到的结果。把其中一个数字单独复制出来，会丢掉它与名称、版本的对应关系。

家族名称是入口，Family.ID 是本次连接的结果

Conn.GetFamily(name) 的职责就是按名称查询 generic netlink family。查询成功后，返回值同时带有 Family.ID 和 Family.Version。这里的关键分工是：

• name：代码用来表达“我要找哪个家族”的稳定入口，例如 nlctrl 或具体协议注册的名称。
• ID：把已发现的家族交给当前连接发送消息时使用的数值地址。
• Version：随家族发现结果带回的版本字段，构造消息头时应使用与目标协议匹配的值。

为什么硬编码编号会在环境变化后失效

硬编码最容易在三个边界上暴露问题。第一，程序连接到另一台机器时，目标家族的注册环境可能不同；第二，连接重建后，旧代码仍然携带脱离发现过程的数字；第三，调试时只记录了数字，没有同时记录家族名称和版本，导致日志很难判断“编号错了”还是“请求版本不匹配”。

这并不意味着每次发送都必须重新查询。合理的边界是：在建立一条 genetlink.Conn 后完成一次发现，把完整的 Family 结果保存在该连接对应的运行时对象中；连接关闭、重连或切换目标环境时，再用名称重新查询。

用 GetFamily 完成运行时发现

下面的例子只演示发现阶段，不假设某个固定的数字 ID。GetFamily 返回“不存在”时可以按业务决定降级；其他错误通常应该保留原始错误并交给上层处理。

package main

import (
	"errors"
	"log"
	"os"

	"github.com/mdlayher/genetlink"
)

func discoverFamily(name string) (genetlink.Family, error) {
	// Dial 使用默认配置建立 generic netlink 连接。
	conn, err := genetlink.Dial(nil)
	if err != nil {
		return genetlink.Family{}, err
	}
	defer conn.Close() // 发现完成后释放底层连接，避免资源泄漏。

	// 按稳定的家族名称查询当前环境中的 Family，而不是猜一个数字。
	family, err := conn.GetFamily(name)
	if err != nil {
		if errors.Is(err, os.ErrNotExist) {
			return genetlink.Family{}, err
		}
		return genetlink.Family{}, err
	}

	log.Printf("family=%s id=%d version=%d", family.Name, family.ID, family.Version)
	return family, nil
}

示例中的 Family.ID 只对这次发现结果有意义。真实程序通常会让连接和 family 一起进入客户端对象，而不是在独立函数结束时把一个数字单独返回给全局变量。

把当前 Family 接到 Execute

发送请求时，使用同一个 Family 中的 ID 和 Version。下面用一个抽象命令号表示协议调用，命令号本身仍然应该来自目标协议的正式定义；文章只讨论 family 编号的获取方式。

package main

import (
	"fmt"

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

func query(conn *genetlink.Conn, family genetlink.Family, command uint8) error {
	request := genetlink.Message{
		Header: genetlink.Header{
			Command: command,
			Version: family.Version, // 使用发现结果携带的版本字段。
		},
	}

	// family.ID 只来自当前连接的发现结果，避免依赖外部硬编码数字。
	messages, err := conn.Execute(request, family.ID, netlink.Request)
	if err != nil {
		return fmt.Errorf("execute family %q: %w", family.Name, err)
	}

	// 返回消息由调用方继续按目标协议的属性定义解码。
	fmt.Printf("received %d messages from %s\n", len(messages), family.Name)
	return nil
}

如果客户端重连，就不能继续无条件复用旧的 Family.ID。可以把“打开连接、按名称发现、保存 Family”封装成一个构造过程，重连成功后完整执行一次，而不是只更新底层 socket。

缓存边界：缓存 Family，不缓存脱离上下文的数字

因此，工程上的“缓存”应当是当前连接对象里的完整发现结果，而不是跨进程、跨机器、跨重启复用的裸数字。若确实需要持久化诊断信息，可以保存名称和版本信息用于观察，但下次启动仍应按名称重新发现。

排查清单与结论

1. 先看代码是否存在固定的 uint16 family ID，而没有对应的名称查询。
2. 确认 GetFamily 和后续 Execute 使用的是同一个连接生命周期。
3. 日志同时记录 Family.Name、Family.ID 和 Family.Version，不要只打印数字。
4. 发生重连、换机器或内核协议环境变化时，丢弃旧的 Family 结果并重新发现。

Go genetlink 家族编号不宜硬编码，核心不是“数字永远不能出现在代码里”，而是不要把一次运行时发现结果误当成稳定协议标识。用名称找到家族，用当前连接返回的 ID 和 Version 发请求，把缓存边界绑定到连接生命周期，代码才能在环境变化后保持可解释性。

相关问题

GetFamily 每次请求前都要调用吗？

不需要。通常在连接建立或重连后发现一次，并在该连接仍有效时复用完整的 Family 结果。

为什么日志里还要记录 ID？

ID 对当前连接的请求仍然重要，记录它可以帮助排查；不应把“需要记录和使用”误解成“可以跨环境永久复用”。

Family.Version 能不能也写死？

版本字段和具体协议有关。除非目标协议的正式文档明确规定固定值，否则优先使用发现结果，并把命令与版本的兼容关系交给协议定义。