Windows 下 Vite dev server 仅监听 ::1 导致 127.0.0.1:5173 无法访问（需显式设置 host=127.0.0.1）

[AdamIsKin]

一、现象：

1. 在 Windows 上运行 frontend 的 npm run dev，终端显示 VITE ... ready 且提示 http://localhost:5173/。

2. 但浏览器访问 http://127.0.0.1:5173/（以及部分情况下 http://localhost:5173/）无法打开。

3. Chrome/Edge Network 面板常见表现：Response headers (0)、Provisional headers are shown；有时控制台出现 chrome-error://chromewebdata/ 相关报错。

4. netstat -ano | findstr :5173 只看到 [::1]:5173 LISTENING，看不到 127.0.0.1:5173 LISTENING。

二、根因：

1. Vite dev server 在该环境下默认只绑定到了 IPv6 回环地址 ::1。

2. 当用户用 IPv4 回环 127.0.0.1 访问时，因服务未监听 IPv4，TCP 连接失败，导致页面打不开。

3. 将 server.host 显式设置为 127.0.0.1 后，Vite 绑定 IPv4，问题消失。

三、复现步骤

1. Windows 上进入 frontend 执行 npm run dev

2. 访问 http://127.0.0.1:5173/ 失败

3. 执行 netstat -ano | findstr :5173 仅看到 [::1]:5173 监听

四、期望行为

1. npm run dev 后应同时监听 IPv4/IPv6，或至少让 127.0.0.1 可访问（更符合多数 Windows 用户直觉）。

2. 或在项目配置中明确绑定 IPv4，避免环境差异导致“服务看似启动但无法访问”。