VS2019发布至Windows Server 2016时WDeployConfigWriter登录失败
Web Deploy 发布异常(WDeployConfigWriter登录失败)定位与解决方案
已知故障基线
- 环境:Visual Studio 2019 发布到 Windows Server 2016,使用 Web Deploy 9.0 版本
- 故障表现:
- 非管理员账户触发预览发布、全量发布流程失败
- 非管理员账户执行单文件发布流程正常
- 管理员账户执行全量发布、预览流程完全正常
- 跟踪日志核心报错:
Microsoft.Web.Delegation.DeploymentAuthorizationException: Not able to log on the user '.\WDeployConfigWriter'. ---> System.Runtime.InteropServices.COMException: The user name or password is incorrect. - 已验证排除项:WDeployConfigWriter 账户未设置密码过期;服务器从2018年起运行正常,故障为近1个月出现。
核心故障逻辑
WDeployConfigWriter 是 Web Deploy 委托体系下的专用本地服务账户,专门承担需要高权限的配置类操作(IIS元数据读写、web.config敏感配置节写入),其凭据校验不通过时会出现上述差异化故障表现,原因在于:
- 单文件发布仅涉及站点物理路径的文件拷贝操作,不触发需要WDeployConfigWriter身份的配置写入流程,因此不受该账户凭据异常影响
- 管理员发布时直接使用自身高权限完成所有操作,不调用委托规则的WDeployConfigWriter替身流程,因此不受该账户凭据异常影响
- 预览、全量发布流程需要枚举配置变更项、写入IIS配置元数据,必须调用WDeployConfigWriter身份完成操作,因此会触发凭据校验失败
之前排查操作失效的原因
- 手动更新WDeployConfigWriter账户密码时,未同步更新委托规则配置中存储的加密密码,也未清除Web管理服务的凭据缓存,导致实际存储的凭据和本地账户密码不匹配
- 运行
AddDelegationRules.ps1脚本时,若未使用管理员权限的提升态命令行执行,脚本会因权限不足无法写入系统配置、无法修改本地服务账户密码,操作实际未生效 - Web Deploy安装修复流程仅覆盖程序自带的二进制文件,不会修改已持久化的委托规则配置和Web管理服务的本地缓存,无法解决凭据不匹配问题
- 删除委托规则和WDeployConfigWriter账户后重建时,未清理Web管理服务的旧缓存文件,导致服务还是会加载历史残留的凭据条目,引发密码校验失败
分步修复操作
- 核对系统配置中的委托规则凭据
打开服务器路径下的配置文件C:\Windows\System32\inetsrv\config\applicationHost.config,搜索<delegation>节点,定位所有关联WDeployConfigWriter的规则条目,确认规则配置中存储的用户名、加密密码和本地WDeployConfigWriter账户的当前密码匹配。若之前重置过本地账户密码,需要同步更新规则中的密码存储。 - 清理Web管理服务(WMSVC)的凭据缓存
这一步是常规修复操作最容易遗漏的环节,WMSVC会对委托凭据做独立的加密缓存,不清除缓存的情况下,就算修改了系统配置文件,服务还是会加载旧凭据:- 停止
Web Management Service系统服务 - 删除缓存目录
C:\Program Files\Web Deployment Agent Service\Tokens\下的所有文件 - 打开本地安全策略,检查「本地策略 -> 用户权限分配 -> 允许本地登录」列表,确认WDeployConfigWriter账户未被最近的安全更新自动移除(Windows Server 2016的月度安全更新有时会重置本地服务账户的登录权限)
- 重启
Web Management Service服务,让服务重新加载系统配置中的最新凭据
- 停止
- 验证本地账户登录有效性
在服务器本地打开提升权限的命令行,执行以下命令模拟服务账户的登录流程:runas /user:.\WDeployConfigWriter cmd.exe
输入该账户的当前密码,确认可以正常弹出命令行窗口,不存在密码错误的报错。如果这一步登录失败,直接在计算机管理中重置WDeployConfigWriter的密码,确保和配置文件中存储的密码完全一致后,重复清缓存、重启服务的操作。 - 流程验证
使用非管理员账户在Visual Studio 2019中触发预览发布流程,跟踪日志确认不再出现WDeployConfigWriter登录失败的报错。
内容的提问来源于stack exchange,提问作者Tor-Erik
相关产品推荐
相关产品推荐

