Windows11下VSCode连接远程Linux服务器提示xhr failed如何解决

按以下优先级逐一排查，绝大多数同类报错都能解决：

1. 本地网络/代理配置拦截 #

• 打开VSCode设置，搜索http.proxy，如果本地没有开代理直接清空该配置项，同时关闭http.proxyStrictSSL选项，避免证书校验拦截请求
• 临时关闭Windows系统防火墙、第三方杀毒/安全软件测试，这类软件经常误拦截VSCode远程连接的本地回环请求
• 打开PowerShell执行ssh 你的远程用户名@服务器IP，先确认基础SSH连接能正常连通，如果SSH本身连不上，先排查服务器22端口是否放行、本地到服务器的网络是否有路由阻断，可执行tracert 服务器IP定位断点。

2. 远程服务端残留进程/锁文件冲突 #

这是Remote-SSH插件最高发的故障原因，之前连接异常断开后，残留的vscode-server进程和锁文件会阻塞新连接的xhr请求：

1. 通过SSH直接登录远程Linux服务器，执行以下命令清理残留：

# 强制结束所有残留的vscode-server进程
pkill -9 -f vscode-server
# 删除所有残留锁文件
rm -rf ~/.vscode-server/.*.lock
rm -rf ~/.vscode-server/bin/*/vscode-remote-lock.*

2. 本地完全退出VSCode后重新打开，再次发起远程连接测试。

3. 本地VSCode组件损坏/版本兼容问题 #

• 按Ctrl+Shift+P调出命令面板，执行Remote-SSH: Kill VS Code Server on Host，选择出问题的远程主机，强制删除服务端旧版本组件后重连
• 如果是刚更新完VSCode或者Remote-SSH插件后出现的报错，直接把Remote-SSH插件卸载重装，或者回退VSCode到上一个稳定版本，新版本经常出现兼容bug
• 关闭VSCode后进入%APPDATA%\Code\Cache目录，清空该目录下所有缓存文件，再重启VSCode测试。

4. 服务端环境异常 #

• SSH登录远程服务器执行df -h，检查家目录所在磁盘分区的使用率，如果分区占满100%，vscode-server无法写入运行文件就会触发xhr报错，清理磁盘保证至少1G以上剩余空间再重试
• 执行chown -R $USER:$USER ~/.vscode-server修复目录权限，避免之前用root执行过相关操作导致普通用户无读写权限。

如果以上操作都无效，打开VSCode输出面板，选择Remote - SSH日志通道，查看xhr请求具体超时的端口和地址，针对性排查端口占用、网络拦截问题即可。

内容的提问来源于stack exchange，提问作者codingNinja