Ionic React项目ionic build后打开index.html报静态资源找不到错误
当前构建产物的所有静态资源都采用站点根绝对路径引用,配合页面内的<base href="/">标签,当通过file://协议直接双击打开本地index.html时,浏览器会将/static/js/xxx.chunk.js这类路径解析为磁盘分区根目录(也就是报错里的file:///D:/static/...路径),完全定位不到构建产物文件夹内的对应资源,最终触发文件不存在的加载错误。
调整构建公共路径
Ionic React 底层基于 Create React App 打包体系,默认公共路径配置为站点根路径/,需要在项目根目录package.json的构建命令前增加PUBLIC_URL=.环境变量,将公共路径设置为相对于当前index.html的相对路径。
示例调整前后对比:
原命令:"build": "ionic build"调整后:
"build": "PUBLIC_URL=. ionic build"这个配置会自动把所有HTML中引用的JS、CSS、图片、manifest等资源的绝对路径
/static/xxx替换为相对路径./static/xxx,同时自动修正<base>标签的href值,完全适配file协议的路径解析规则。替换为Hash路由实现
默认使用的BrowserRouter在file协议环境下,一旦触发路由跳转,浏览器会尝试查找对应路径的本地文件,直接导致白屏。需要将路由初始化代码里的BrowserRouter替换为HashRouter:
原代码示例:import { BrowserRouter } from 'react-router-dom'; <BrowserRouter> <App /> </BrowserRouter>调整后:
import { HashRouter } from 'react-router-dom'; <HashRouter> <App /> </HashRouter>Hash路由会将所有路由路径放在URL的
#标识符之后,不会触发浏览器的本地文件路径查找逻辑,完全适配无本地HTTP服务的运行场景。清理残留硬编码绝对路径
部分没有被构建工具自动处理的硬编码绝对路径,需要手动补充相对路径前缀.,比如:- 原manifest引用标签:
<link rel="manifest" href="/manifest.json" />,调整为<link rel="manifest" href="./manifest.json" /> - 原favicon引用标签:
<link rel="shortcut icon" type="image/png" href="/assets/icon/favicon.png" />,调整为<link rel="shortcut icon" type="image/png" href="./assets/icon/favicon.png" />
- 原manifest引用标签:
完成所有配置调整后重新执行构建命令,打开默认生成的build产物目录,直接双击目录内的index.html即可正常加载项目,所有静态资源都能通过相对路径正确匹配,不会再出现ERR_FILE_NOT_FOUND报错,路由跳转、页面交互都可正常运行。
内容的提问来源于stack exchange,提问作者vishnu vinod

