为什么夸克浏览器无法读取手机本地HTML文件？

许多用户在使用夸克浏览器打开本地HTML文件时，常遇到白屏或报错现象。问题根源并非文件本身，而是夸克浏览器基于Chromium内核，默认对file://协议施加了严格限制。每个file:///路径被视作独立源（origin为null），导致fetch()、import、相对路径的CSS、JS或图片资源均被拦截——即便图片与HTML位于同一文件夹，也可能报net::ERR_FILE_NOT_FOUND，或直接呈现空白页面。

简而言之，不是文件存放位置错误，而是浏览器主动阻止了跨文件读取行为。夸克对本地HTML的限制，与主流手机浏览器一致：所有file://页面均被视为“孤立沙盒”，无法发起网络请求，也无法读取同目录下的其他文件。

根本原因：file://协议被严格限制

手机浏览器（包括夸克）将每个file://页面视为独立源，origin为null，这意味着它无法发起任何网络请求，不能读取同目录的其他文件，也无法执行ES模块导入。即使图片和HTML在同一文件夹，路径写成./img.png，夸克也可能报net::ERR_FILE_NOT_FOUND或直接白屏。

安卓厂商定制的浏览器偶尔会对简单页面“宽松处理”，但夸克内核（基于Chromium）默认启用严格策略。而iOS上的Safari更彻底——完全不支持file://跨文件访问，打开单个index.html都可能找不到script.js。

验证是否真被拦截

想确认自己遇到的问题是否由该原因引起？方法很简单：打开夸克浏览器，在地址栏输入file:///storage/emulated/0/your-folder/index.html，等待加载完成。然后点击地址栏左侧的锁形图标，选择“检查网站信息”，查看是否有红色警告提示“此页面使用不安全的协议”或“部分功能已被禁用”。

如果更专业一些，可以打开开发者工具的控制台——如果报错信息是Access to script at 'file:///...' from origin 'null' has been blocked，则说明file://安全策略正在生效。

临时绕过方案（仅限纯静态页）

如果只是临时查看，有两个凑合的方法，但限制较多。

方法一：确保页面完全无外部依赖。删除所有、、fetch()调用；图片的src必须使用base64内联或data URI；HTML文件保存为UTF-8无BOM格式；路径中绝对不能包含中文、空格、括号。这种页面基本等于一张白纸，实用性有限。

方法二：用文件管理器强制调用夸克打开。在手机文件管理器中长按index.html，选择“用其他应用打开”，然后选夸克浏览器。如果弹出“已允许访问此文件”的提示，则成功；否则仍会空白或报错。

真正可靠的解决路径

要彻底解决，必须告别file://，改用本地HTTP服务。操作并不复杂。

第一步：安装Termux（安卓）或iWeb Browser（iOS）。安卓用户从F-Droid或GitHub下载Termux，然后运行pkg install python安装Python。iOS用户在App Store搜索iWeb Browser并安装。

第二步：启动本地HTTP服务。安卓：进入HTML所在文件夹，在Termux中执行python3 -m http.server 8000，然后在夸克浏览器访问http://localhost:8000。iOS：打开iWeb Browser，点击“+”选择HTML所在文件夹，再点“Start Server”，浏览器会自动跳转到http://127.0.0.1:8080。

第三步：确认资源全部正常加载。此时所有相对路径、AJAX、ESM模块、图片都能正确解析，控制台里不再出现file://相关的报错，页面功能完整可用。