📍 WDQWDWQD987AAAAA:216.73.217.13
📱 Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
🔗 /456fa41662b7.html
📄

本地网站开发 - 怎样检查访问状态与错误页

检查本地网站开发中的访问状态与错误页，核心是让请求真正到达你正在开发的那台机器或那个端口，并区分“服务没起来”“路径不对”“端口被占用”“防火墙拦截”这几类不同结果。最直接的起点是：打开浏览器开发者工具的 Network 面板，或使用命令行工具请求本地地址，观察返回的状态码与响应内容。状态码 200 表示页面正常返回；404 表示路径存在但资源找不到；500 表示服务端代码抛错；连接被拒绝则说明服务根本没有在监听。

从一个假设的例子开始

假设你在本地开发一个博客页面，访问 http://localhost:3000/posts 时浏览器显示“无法访问此网站”。这时不要立刻改代码，先按下面顺序排查。

1. 确认服务进程是否在运行。回到启动开发服务器的终端窗口，看它是否仍在输出日志、有没有报错退出。如果终端已经回到命令提示符，说明进程已结束，需要重新启动。
2. 确认监听的端口号。启动日志里通常会打印实际监听地址，例如 http://localhost:3000 或 http://127.0.0.1:5173。端口写错是常见问题，浏览器地址栏里的端口必须与日志一致。
3. 用命令行请求一次。执行 curl -I http://localhost:3000/posts，只看响应头。如果返回 HTTP/1.1 200 OK，说明服务正常，问题在浏览器缓存或前端路由；如果提示 Connection refused，说明没有进程监听该端口。
4. 检查路径与路由配置。如果返回 404，说明服务在跑，但没有匹配到 /posts 这个路径。检查路由文件里是否定义了该地址，以及大小写、结尾斜杠是否一致。

常见错误页分别意味着什么

不同状态码指向不同层面，判断时不要混为一谈。

• 404 Not Found：服务已响应，但找不到对应资源。可能是路径拼写错误、静态文件目录配置不对，或前端路由未做回退处理。单页应用直接访问子路径时经常出现这种情况，需要服务端把未知路径回退到入口 HTML。
• 500 Internal Server Error：请求已经进入服务端代码，但执行过程中抛出异常。此时应查看终端里的错误堆栈，而不是继续改前端。
• 502 / 504：通常出现在本地有反向代理时，表示代理无法从后端拿到有效响应，或后端超时。检查代理配置里的目标地址和端口是否正确。
• 浏览器自己的错误页：“无法访问此网站”“连接已重置”这类页面不是服务器返回的，而是浏览器在连接阶段就失败了。它对应的是网络层或进程层问题，不是 HTTP 状态码问题。

用开发者工具定位具体请求

打开浏览器开发者工具，切到 Network 面板，勾选 “Disable cache”，然后刷新页面。逐条查看请求：

• 看 Status 列，确认是 200、304、404 还是失败（显示为 (failed) 或 (canceled)）。
• 点开某条请求的 Headers，核对 Request URL 是否指向你期望的本地地址和端口。
• 看 Response 或 Preview，确认返回的是页面内容、JSON 数据，还是一段错误信息。
• 如果某条请求显示 (failed) 且没有状态码，把鼠标悬停在上面，通常会提示 net::ERR_CONNECTION_REFUSED 或 net::ERR_CONNECTION_TIMED_OUT，这两者分别指向“没有服务监听”和“连接被拦截或超时”。

需要额外注意的两种情况

端口被占用。如果启动服务时报 EADDRINUSE，说明该端口已被其他进程使用。可以换一个端口启动，或先找到并结束占用进程。判断方法：换端口后能正常访问，就说明原端口冲突。

只监听 127.0.0.1 还是 0.0.0.0。有些开发服务器默认只绑定本机回环地址，此时用 localhost 能访问，但用局域网 IP 从手机访问会失败。如果需要在其他设备上测试，要确认启动参数是否允许外部访问，并检查系统防火墙是否放行该端口。

下一步可以做什么

选定一个当前无法访问的本地地址，按“终端进程 → 监听端口 → 命令行请求 → 浏览器 Network 面板”的顺序走一遍，记录每一步的实际输出。把失败发生在哪一层确定下来之后，再针对那一层去改配置或代码，比反复刷新页面更有效。