VDS Upgrade got stuck with "The vSphere Distributed Switch configuration on some hosts differed from that of the vCenter Server" error

Products

• VMware vCenter Server

Issue/Introduction

In vCenter > Networking > vDS > Summary, you see the warning: 

"The vSphere Distributed Switch configuration on some hosts differed from that of the vCenter Server."

In vCenter /storage/log/vmware/vpxd/vpxd.log

2026-02-09T16:19:35.401Z info vpxd[1991406] [Originator@6876 sub=vmomi.soapStub[1085] opID=487d02ff] SOAP request returned HTTP failure; <<io_obj p:0x00007fa
548879598, h:236, <UNIX '',> <UNIX '/var/run/envoy-hgw/hgw-pipe'>>, /hgw/host-####/vpxa>, method: applyDVPort; code: 500 (Internal Server Error); fault: (vi
m.fault.DvsApplyOperationFault) {
   faultCause = (vmodl.MethodFault) null,
   faultMessage = <unset>,
   objectFault = (vim.fault.DvsApplyOperationFault.FaultOnObject) [
      (vim.fault.DvsApplyOperationFault.FaultOnObject) {
         objectId = "26059",
         type = "vim.dvs.DistributedVirtualPort",
         fault = (vim.fault.PlatformConfigFault) {
            faultCause = (vmodl.MethodFault) null,
            faultMessage = <unset>,
            text = "Failed to update port persistence location",
            msg = "An error occurred during host configuration."
         }

Environment

VMware vCenter Server 8.x
VMware ESXi 8.x

Cause

There are many possible causes of this condition.  Regardless, the same resolution will eliminate the symptoms.

Resolution

Please follow the steps in this KB to resolve these symptoms --> KB 412915 - "The vSphere Distributed Switch configuration on some hosts differed from that of the vCenter Server" seen in the vCenter Networking icon view, Summary tab of a vDS

Additional Information

Troubleshoot ESXi host out of sync issue with DVS:

ESXi hosts showing out of sync with distributed switch