← 中文资源

简体中文版本

浏览器 ERR_CONNECTION_REFUSED — 无法访问此网站

诊断浏览器的 ERR_CONNECTION_REFUSED:检查监听、端口、IPv6/IPv4 绑定及开发服务器配置。

阅读英文原文

症状

浏览器显示 ERR_CONNECTION_REFUSED 并立即失败,这有别于超时。终端里开发服务器可能还打印了 “ready”,使这个拒绝更令人困惑。

诊断

检查确切的绑定地址并独立测试:

ss -ltnp | grep 3000
curl -v http://localhost:3000

若绑定地址是 127.0.0.1,而浏览器把 localhost 解析为 ::1,即便服务器在运行,连接也会被拒绝。

修复

绑定可访问的地址,并保持主机名写法一致:

# Vite
vite --host 0.0.0.0 --port 5173

浏览器中请用 http://localhost:5173,除非已绑定 0.0.0.0,否则不要用局域网 IP。

验证

重新加载页面,页面正常渲染且不再报连接错误。curl -v 从同一端口返回 200,说明监听方与浏览器在地址和端口上已一致。