编程 udev 规则改了不生效:reload 只重读文件、trigger 默认发 change、test 不跑 RUN

2026-11-23 00:08:42

udev 规则改了不生效:reload、trigger、RUN 是三件事

udev 规则改完不生效,多数时候并非规则写错,而是三个环节中某一环没走通:systemd-udevd 是否读到了磁盘上的新规则,事件是否按你期望的 ACTION 重新发生,规则匹配后 RUN 指定的程序是否真的被调用。这三件事分别对应 udevadm control --reload、udevadm trigger 和执行阶段,任何一环缺掉,ls /dev 的结果都不会变。

排查顺序建议固定下来:先 udevadm test 看匹配链是否命中,再用 journalctl / udevadm monitor 看程序有没有被调用,最后才看 /dev 或网卡名有没有变成你要的样子。

参考文档:udev(7)、udevadm(8)。

一、规则读哪几个目录,同名谁赢

规则从这四个目录读:/usr/lib/udev/rules.d、/usr/local/lib/udev/rules.d、/run/udev/rules.d、/etc/udev/rules.d。

关键点是所有目录里的规则文件按文件名字典序统一排序处理,而不是先目录后文件。同名文件互相替换:/etc 优先级最高,/run 优先于 /usr 下的同名文件。所以在 /etc/udev/rules.d 放一个同名软链指向 /dev/null,就能整体禁掉某个规则文件:

sudo ln -sf /dev/null /etc/udev/rules.d/70-persistent-net.rules

文件名后缀必须是 .rules,其它后缀会被直接忽略——写成 .rule 或 .rules.bak 不会有任何报错,只是不生效。

二、--reload 只重新读盘,不动既有设备

udevadm control --reload   # -R

手册原文说得很明确:重载规则与数据库不会对已存在的设备应用任何变更,新配置只对之后的新事件生效。所以单独执行它,设备节点、链接、网卡名一个都不会变,这是设计如此。

它的另一个问题是静默无输出,成功了不打字,配置有语法错误也常常不吭声,看上去像是"已经生效"。修完规则记得配合 udevadm verify 做静态检查(语法、语义、风格),退出码 0 才算通过;老版本没有这个子命令。

三、trigger 的 ACTION 默认是 change

udevadm trigger -c add --subsystem-match=block

udevadm trigger 的 -c/--action 默认值是 change。这意味着你写的 ACTION=="add" 规则在热重放时永远不命中,只有新插入设备才会触发。必须显式指定:

udevadm trigger --action=add

systemd issue #17594 就是这个场景:规则放在 /etc/udev/rules.d,执行 udevadm control --reload-rules && udevadm trigger 后网卡名不变,重启才生效。yuwata 的回复是改用 udevadm trigger --action=add,否则带 ACTION=="add" 的规则根本不会被应用到该接口上。

重放时务必用 --subsystem-match、--sysname-match、--name-match 缩小范围,别把整个系统的事件重放一遍;-n/--dry-run 可以先看会触发什么。

四、udevadm test 只证明匹配链命中

udevadm test /sys/class/block/sdb
udevadm test --action=add /sys/class/net/enp0s31f6

test 是模拟运行并打印调试输出,它不会执行 RUN 指定的程序,输出里也会提示结果可能不准确。它的 -a/--action 默认是 add,与 trigger 的默认值相反,别把两者混着看。

所以 test 通过只说明匹配链走到了,不能说明 RUN 会跑。例如 KERNEL=="sdb", ACTION=="add", SYMLINK="my_disk" 这种规则,test 会把 LINK 'my_disk' 和 DEVLINKS 打出来,此时 ls /dev 里还没有这个链接——链接是后续处理阶段才建的。

-D/--extra-rules-dir 和 -v/--verbose 是 systemd v258 才加的,老版本上报参数错误不代表规则有问题。

五、PROGRAM 是匹配键,RUN 是赋值键

SUBSYSTEM=="block", PROGRAM=="/usr/lib/udev/mydisk", RUN+="/usr/bin/logger $result"

PROGRAM 用于匹配:程序成功返回即视为该键为真,stdout 进入 RESULT。RUN 用于赋值:等该事件的所有规则处理完之后才执行。

替换时机不同,这是最容易出问题的地方:RUN 里的 $result/%c 在所有规则处理完、执行之前才替换,而 ENV、MODE、SYMLINK 等键在该行被处理时就替换。后果是,如果两条规则各带 PROGRAM 且都在 RUN 里用 $result,后一条会覆盖前一条的结果(systemd issue #12291)。维护者认可这是晚期替换带来的行为,并提到提前求值存在兼容性风险。

六、RUN 是一张共享列表

  • RUN+= 追加到列表;
  • RUN= 或 RUN:= 清空整张列表后重新赋值——program 与 builtin 共用同一张表,所以一条 RUN= 会把前面追加的 builtin 也一起清掉;
  • RUN{builtin} 自 v199 起支持;
  • := 最终赋值自 v247 起支持,禁止后续修改。

七、RUN/PROGRAM 只能做极短的前台活

systemd-udevd 默认沙箱禁止访问网络,禁止 mount/umount。事件处理结束后,派生进程无论是否 detach 都会被无条件 kill。要拉起长驻服务,正确做法是给一个 service unit,用设备属性把它带起来:

SUBSYSTEM=="usb", ENV{SYSTEMD_WANTS}="mydaemon.service"

改名链路上还有两个坑:

99-default.link 的 NamePolicy=kernel database onboard slot path,其中包含 keep,会让改名不落地。接口已经 up 时改名会报 EBUSY:

Failed to rename network interface 7 from 'enp0s31f6' to 'mylan0': Device or resource busy

先 ip link set enp0s31f6 down 再 trigger。想先确认会改成什么名字,用:

udevadm test /sys/class/net/wlan0 --json=pretty 2>/dev/null | jq .networkInterface.name

输出即预测的新接口名(示例中为 wlp59s0)。.link 文件由 udevd 使用,改完同样需要 udevadm trigger --action=add /sys/class/net/X 或重启。

九、回到排查顺序

  1. udevadm verify 检查语法,udevadm test --action=add /sys/class/... 看匹配链;
  2. udevadm monitor --udev --property 或 journalctl -u systemd-udevd -f 看事件有没有来、RUN 里的程序有没有被调用;
  3. 最后看 /dev 下的节点/链接或网卡名是否变了。

卡在某一步时,先确认自己卡的是"读规则"、"重放事件"还是"执行"——这三段各有各的默认值,reload 静默、trigger 默认 change、test 默认 add,任何一个默认值没对上,现象都是"规则改了不生效"。

复制全文 生成海报 udev Linux systemd 运维 Shell 设备管理

推荐文章

程序员茄子在线接单