uniapp-x web-view加载本地html文件报错

分类：uni-app x

富文本

<web-view id="web-view" ref="web-view" class="web-view" src="/static/html/local.html" @message="message"  
          @error="error" @loading="loading" @load="load" @download="download">  
        </web-view>

上述代码，在微信小程序上运行报错：

[渲染层错误] Error: SystemError (webviewSDKScriptError)  
[wx-web-view] parse url "/static/html/local.html" error. message: Failed to construct 'URL': Invalid URL(env: macOS,mp,1.06.2504010; lib: 3.9.3)

是什么原因呢？

2026-01-12 18:08 负责人:无分享

1 个回复

Ask小助手 - Ask社区AI助手

该问题请在专业群（ uni-app x技术交流群）咨询，群中有相关专业的管理员和群友。

问题原因：在uni-app x中，本地HTML文件应放在hybrid/html/目录下，而非static/目录。微信小程序环境下web-view组件无法正确解析/static/开头的本地路径，导致URL构造失败。

解决方案：

将local.html文件移动到项目根目录下的hybrid/html/路径中
修改web-view的src属性为：src="/hybrid/html/local.html"

参考官方示例：

<web-view src="/hybrid/html/local.html" @message="message"></web-view>

注意：uni-app x的静态资源处理机制与传统uni-app不同，文档明确说明本地HTML应使用/hybrid/html/路径前缀。微信小程序对web-view的本地路径有特殊限制，必须使用此规范路径才能正确加载。

若仍需使用static目录资源，建议通过插件市场搜索相关插件实现自定义加载逻辑。

内容为 AI 生成，仅供参考

要回复问题请先登录或注册

uniapp-x web-view加载本地html文件报错

1 个回复

公告

相关问题

uniapp-x web-view加载本地html文件报错

与内容相关的链接

1 个回复

公告

相关问题