Debian11 Hyper-V配置VM网络缺失KVP守护进程文件报错排查

报错核心是Debian 11官方软件源提供的hyperv-daemon组件默认不内置hv_set_ifconfig网络配置执行脚本：该脚本是早期微软Linux Integration Services(LIS)安装包、RHEL/CentOS类发行版默认集成的组件，Debian从10版本开始就将该脚本从默认Hyper-V daemon包中移除，主机通过KVP通道下发IP配置指令时找不到对应执行文件，就会触发虚拟机端「文件不存在」日志，以及宿主端15090: failed to modify resources报错。

虚拟机内（Debian 11）操作 #

• 先确认Hyper-V KVP服务正常运行，执行以下命令启动并设置开机自启：

sudo systemctl enable --now hv-kvp-daemon
sudo systemctl status hv-kvp-daemon

执行后确认服务状态为active (running)即可。

• 如果之前手动安装过微软官网提供的旧版独立LIS安装包，先执行命令卸载，避免和内核自带的LIS驱动冲突：

sudo apt remove --purge -y lis*

• 创建缺失的脚本存放目录：

sudo mkdir -p /usr/libexec/hypervkvpd/

• 新建hv_set_ifconfig脚本（适配Debian 11默认自带的iproute2工具链，自动转换点分子网掩码为CIDR格式，不依赖额外组件），执行以下命令写入内容：

sudo tee /usr/libexec/hypervkvpd/hv_set_ifconfig << 'EOF'
#!/bin/bash
# 点分十进制子网掩码转CIDR前缀长度
mask2cidr() {
    local x=${1##*255.}
    set -- 0^^^128^192^224^240^248^252^254^ $(( (${#1} - ${#x})*2 )) ${x%%.*}
    x=${1%%$3*}
    echo $(( $2 + (${#x}/4) ))
}

# 读取KVP通道下发的网络配置文件
IFCFG_FILE=$1
source $IFCFG_FILE
IFACE=$DEVICE

# 清空网卡原有配置
ip addr flush dev $IFACE
ip link set $IFACE up

# 配置IP地址与子网掩码
IFS=' ' read -ra IP_LIST <<< "$IPADDR"
IFS=' ' read -ra NETMASK_LIST <<< "$NETMASK"
for idx in "${!IP_LIST[@]}"; do
    CIDR=$(mask2cidr "${NETMASK_LIST[$idx]}")
    ip addr add "${IP_LIST[$idx]}/$CIDR" dev $IFACE
done

# 配置默认网关
if [ -n "$GATEWAY" ]; then
    ip route del default 2>/dev/null
    ip route add default via "$GATEWAY" dev $IFACE
fi

# 配置DNS服务器
if [ -n "$DNS1" ] || [ -n "$DNS2" ]; then
    : > /etc/resolv.conf
    [ -n "$DNS1" ] && echo "nameserver $DNS1" >> /etc/resolv.conf
    [ -n "$DNS2" ] && echo "nameserver $DNS2" >> /etc/resolv.conf
fi

exit 0
EOF

• 给脚本添加可执行权限，重启KVP服务加载配置：

sudo chmod +x /usr/libexec/hypervkvpd/hv_set_ifconfig
sudo systemctl restart hv-kvp-daemon

Hyper-V宿主端（Windows 11）操作 #

• 必须使用系统内置的Windows PowerShell 5.1运行你提供的Set-VMNetworkConfiguration函数，不要使用PowerShell 7，后者对老版WMI v2命名空间的.GetRelated()方法兼容存在缺陷，无法正常执行。
• 执行IP配置前先确认虚拟机的KVP交换功能已启用：

Get-VMIntegrationService -VMName debian-vm -Name "Key-Value Pair Exchange" | Enable-VMIntegrationService

• 重新执行IP配置命令即可生效，配置完成后可进入虚拟机执行ip a、ip route、cat /etc/resolv.conf验证IP、网关、DNS配置是否正确。

• 第二代Debian 11虚拟机必须使用Hyper-V合成网络适配器，不要添加旧版遗留网络适配器，否则KVP通道无法正常传递网络配置。
• 不要修改/var/lib/hyperv/目录的默认权限，该目录是KVP服务存放临时配置文件的路径，权限异常会导致配置文件无法写入。

内容的提问来源于stack exchange，提问作者Juan C. París