鸿蒙WebView加载本地HTML资源404的根本原因是不支持rawfile目录相对路径自动映射，必须通过arkwebview://协议+路径映射或预加载重写路径实现资源访问，且需严格对齐目录结构、统一小写文件名、声明UTF-8编码并启用allowContentAccess。
鸿蒙混合开发中，HTML文档无法直接通过 file:// 协议加载本地 rawfile 资源（如图片、CSS、JS），浏览器会报 net::ERR_UNKNOWN_URL_SCHEME 或 404；必须用 arkwebview:// 协议 + 正确路径映射才能访问。
鸿蒙 WebView 加载本地 HTML 时资源 404 的根本原因
鸿蒙的 WebView 默认不支持直接解析 rawfile/ 目录下的相对路径引用。比如 HTML 中写 <img src="images/cover.jpg">，即使 cover.jpg 确实放在 resources/base/rawfile/images/ 下，WebView 仍会按当前页面 URL 基准去拼接路径，最终尝试请求类似 arkwebview://assets/images/cover.jpg 这类不存在的地址。
- 鸿蒙 WebView 的资源加载器不会自动将
rawfile/映射为可访问的协议路径 -
file:///data/app/xxx/files/...这类绝对路径在鸿蒙沙箱环境下被限制，且不可靠 - 使用
loadUrl("file://...") 方式加载 HTML 文件本身可能成功，但其内联引用的子资源（CSS/JS/图片）全部失效
正确映射 rawfile 资源的两种可行方式
核心原则：让 HTML 中所有 src / href 指向的路径，能被鸿蒙 WebView 的资源加载器识别并解析为真实 rawfile 内容。
anything-to-html
下载
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- 方式一：改用
arkwebview://协议 + 资源路径前缀
在 HTML 中统一写成：<img src="arkwebview://rawfile/images/cover.jpg">，然后在WebViewController中注册自定义 scheme 处理器，拦截arkwebview://rawfile/请求并读取对应 rawfile 资源 - 方式二：预加载 HTML 并重写资源路径（推荐）
用getRawFile("index.html")读取 HTML 字符串 → 用正则或 DOM 解析器批量替换所有src="images/xxx"为src="arkwebview://rawfile/images/xxx"→ 再调用loadDataWithBaseURL加载处理后的字符串，baseURL 设为arkwebview://rawfile/ - 注意：CSS 中的
url(...)、@import、JS 动态创建的资源路径，同样需要被替换或拦截，否则仍 404
HTML 结构与 rawfile 目录结构必须严格对齐
鸿蒙 rawfile 资源在构建时会被扁平化打包，目录层级保留，但无“虚拟根目录”概念——rawfile/a/b/c.js 就是它唯一的逻辑路径，不能靠 ../ 跳转到上级。
立即学习“前端免费学习笔记（深入）”；
- HTML 中所有相对路径都以当前 HTML 文件所在位置为基准，不是以 rawfile 根目录为基准
- 若 HTML 放在
rawfile/views/book.html，而图片在rawfile/assets/img/logo.png，则必须写src="../assets/img/logo.png"，不能写src="/assets/img/logo.png"（鸿蒙不支持 root-relative 路径） - 避免在 HTML 中混用绝对路径（
/xxx）和相对路径（./xxx），容易因加载方式不同（loadUrlvsloadDataWithBaseURL）导致行为不一致 - 建议统一把主 HTML 放在
rawfile/index.html，其他资源按功能分目录（css/、js/、images/），所有引用均用相对路径，减少映射复杂度
调试时最容易忽略的三个细节
很多团队卡在最后一步：明明路径写对了，还是加载失败。问题往往出在非路径本身。
-
resources/base/rawfile/下的文件名必须全小写且不含中文、空格、特殊符号；鸿蒙资源系统对大小写敏感，Cover.jpg和cover.jpg是两个不同资源 - HTML 文件本身必须声明
<meta charset="UTF-8">，否则 rawfile 中含中文的 JS 或 JSON 可能乱码，引发脚本执行中断 - 鸿蒙 WebView 默认禁用
allowContentAccess，如果 JS 需要通过fetch("arkwebview://...")主动拉取 rawfile，必须显式调用setAllowContentAccess(true)，否则返回空响应
