症状
浏览器显示 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,说明监听方与浏览器在地址和端口上已一致。