根本原因是资源协议、路径映射和MIME类型三者未对齐；Android/iOS WebView默认拦截file://跨资源请求，鸿蒙需虚拟域名+rawfile严格路径+显式setMimeType("text/css")。
离线引入本地CSS在WebView中失败，根本原因不是“文件没放对”，而是资源协议、路径映射和MIME类型三者没对齐。直接改href或清缓存大概率无效。
WebView加载file://协议CSS被拦截（Android/iOS通用）
现代WebView默认禁止file://协议下的跨资源请求——哪怕CSS和HTML都在同一目录，JS尝试fetch()或动态link插入也会被同源策略拒绝。这不是bug，是安全加固后的正常行为。
- Android 7.0+ 默认禁用
file://访问网络资源，且不支持file://内JS发起http(s)请求 - iOS WKWebView 完全屏蔽
file://协议的AJAX，连XMLHttpRequest都返回NETWORK_ERR - 鸿蒙
WebView虽支持rawfile，但若HTML用file://打开而非https://example.com/rawfile/，CSS仍会404
鸿蒙rawfile路径映射必须带虚拟域名（鸿蒙专属坑）
鸿蒙不认file://，也不接受相对路径如./style.css。它只响应你显式配置的虚拟域名+/rawfile/前缀组合，且物理路径必须严格匹配entry/resources/rawfile/结构。
- HTML里写
<link rel="stylesheet" href="https://example.com/rawfile/style.css">才有效 -
processResourceRequest()中必须解析uri.getDecodedAuthority()为"example.com"，否则直接跳过 - 真实文件路径必须是
entry/resources/rawfile/style.css，少一个entry/或错写成rawfiles/都会静默失败 - 别依赖IDE自动同步：手动检查
resources/rawfile/是否真的被编译进HAP包（可解压HAP看resources/base/rawfile/）
CSS文件加载但样式不生效（常被忽略的MIME陷阱）
鸿蒙processResourceRequest()返回ResourceResponse时，若没显式设置setMimeType("text/css")，系统可能按扩展名猜测失败，最终返回text/plain——浏览器拒解析，控制台无报错，但样式全丢。
- 对
.css文件，必须在ResourceResponse中调用setMimeType("text/css") - 对
.js文件，对应设为"application/javascript"，不能只写"text/javascript"（鸿蒙部分版本不识别） - 鸿蒙
ResourceResponse构造时，setEncoding("utf-8")也建议显式指定，避免BOM或编码错位导致CSS解析中断
Android WebView强制启用本地资源加载（Android专用补救）
如果必须用file://方案（比如旧项目无法重构），Android需主动放开限制，但仅限可信本地文件：
- Java中调用
webView.getSettings().setAllowContentAccess(true)和setAllowFileAccess(true) - 必须配合
webView.getSettings().setJavaScriptEnabled(true)，否则CSS中的@import或动态样式注入失效 - Android 9+ 需在
AndroidManifest.xml的<application></application>下加android:usesCleartextTraffic="true"（仅调试，上线前删） - 绝对不要用
setAllowUniversalAccessFromFileURLs(true)——Google Play已明令禁止，审核必拒
最易被忽略的点：鸿蒙的rawfile机制和Android的file://机制完全不兼容，同一套HTML无法无缝切换。真要兼顾，得在构建时根据平台条件编译不同的href值，而不是指望运行时自动适配。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
