使用Golang Libvirt API连接QEMU Guest Agent失败求助

针对你用Libvirt Golang API连接QEMU Guest Agent失败的问题，可从以下几点排查：

• 确认API调用方式正确性
  必须使用DomainQemuAgentCommand方法（对应libvirt C API的virDomainQemuAgentCommand），并设置合理的超时时间与标志位。比如设置5秒超时+阻塞模式，示例代码：

  conn, err := libvirt.NewConnect("qemu:///system")
  if err != nil {
      log.Fatal(err)
  }
  defer conn.Close()
  
  dom, err := conn.LookupDomainByName("test-vm")
  if err != nil {
      log.Fatal(err)
  }
  defer dom.Free()
  
  cmd := `{"execute":"guest-info"}`
  result, err := dom.QemuAgentCommand(cmd, 5, libvirt.DOMAIN_QEMU_AGENT_COMMAND_BLOCK)
  if err != nil {
      log.Fatal(err)
  }
  fmt.Println(result)
  

  避免误用其他通道操作API，这是最常见的错误点。

• 权限验证
  你用sudo virsh能成功，但Go程序可能以普通用户运行，没有访问代理通道套接字（/var/lib/libvirt/qemu/channel/target/下的文件）的权限。可将运行程序的用户加入libvirt或kvm组，或临时用sudo运行Go程序测试。

• Libvirt Go绑定版本兼容性
  确保你使用的libvirt-go绑定版本与系统安装的libvirt库版本匹配，老旧版本可能存在API调用的兼容问题，建议升级到最新稳定版。

• 确认Guest Agent状态
  虽然virsh能调用，仍需在虚拟机内部确认qemu-guest-agent服务是否正常运行：

  systemctl status qemu-guest-agent
  

  确保服务处于active (running)状态，无异常日志。

• 检查代码中域对象的有效性
  调用Agent命令前，确认获取的域对象是有效且处于运行状态，可通过dom.GetState()检查域状态是否为VIR_DOMAIN_RUNNING。

内容的提问来源于stack exchange，提问作者Benedict Schlütter