适用范围与准备

适用于浏览器地址以 file:/// 开头,本地 HTML 能显示,但 JavaScript 读取同目录 JSON 或模块时失败。需要有可用的 Python 3 和可信的本地演示文件。本篇建立临时静态预览,不部署网站、不开放公网服务。

先区分原因

本地文件并不因为处于同一个磁盘目录就一定拥有相同来源。现代浏览器通常把本地文件作为不透明来源处理,读取其他本地资源可能被拦截。给本地文件添加网页响应头、关闭浏览器安全检查,都不是可靠的预览方式。

按顺序操作

  1. 在开发者工具中确认失败请求的完整 URL、协议及错误原文。只有 file:// 本地读取符合本篇场景;如果失败的是远程 HTTPS API,需要另查该服务的 CORS 授权,改用本地服务器不会自动获得访问权。
  2. 创建一个独立的预览目录,只放需要的 HTML、脚本、样式和示例数据。不要把服务根目录设为个人主目录或仓库根目录;排除凭据、真实订阅、私钥和指向其他敏感目录的符号链接。
  3. 将下面的目录占位值换成自己的绝对路径,启动服务,明确绑定 127.0.0.1。命令需要 Python 3.7 或更新版本支持 --directory。端口已占用时换一个空闲端口,不结束未知进程。
  4. 在浏览器打开 http://127.0.0.1:8769/index.html,而不是再次双击磁盘文件。让 HTML 与 JSON 都通过同一个协议、主机名和端口提供,避免混用 localhost 与 127.0.0.1 后又变成不同来源。
  5. 观察请求是否实际返回预期 JSON,确认页面按数据更新。404 通常要检查路径和服务根目录;返回 HTML 的 200 也不等于 JSON 读取成功。测试完成在启动服务的终端按 Ctrl+C 关闭。
macOS/Linux;Windows 安装 Python 启动器时用 py -3 替换 python3
python3 -m http.server 8769 --bind 127.0.0.1 --directory "/ABS/PATH/TO/PREVIEW"
失败位置处理方向
file:/// 下读取同目录数据使用同源本地 HTTP 预览
本地 HTTP 页面请求远程 API按远端接口授权与 CORS 排查
本地 HTTP 返回 404核对目录、相对路径和大小写

怎样确认有效

同时确认 Network 面板中目标资源 URL 正确、状态正常、响应内容符合预期,页面功能也完成了原操作。单独看控制台不再报 CORS 不够;Python 的静态服务器不会替你实现登录、后台 API 或生产环境 HTTPS。

无效时恢复与下一步

测试后关闭服务并确认原地址已不能继续提供目录内容,保留演示文件即可。若还需测试后端接口,应使用项目规定的开发服务。Python http.server 会跟随符号链接,且不适合作为生产服务器;不要为本地预览改成对所有网卡监听。