如何解决 Android WebView 加载自定义网站空白的问题

花韻仙語

花韻仙語

2026-07-10

672人浏览

原创

如何解决 Android WebView 加载自定义网站空白的问题

android webview 加载第三方网站(如 softcommerceltd.com)显示空白,而 google 可正常访问,通常是因缺少 dom 存储支持或 url 重定向不兼容导致;本文提供完整解决方案,包括启用 dom storage、规范 url 格式及关键配置检查。

android webview 加载第三方网站(如 softcommerceltd.com)显示空白,而 google 可正常访问,通常是因缺少 dom 存储支持或 url 重定向不兼容导致;本文提供完整解决方案,包括启用 dom storage、规范 url 格式及关键配置检查。

在 Android 应用中使用 WebView 加载自有网站时出现白屏,但 https://google.com 正常,说明 WebView 基础功能无问题,问题往往出在目标网站的运行依赖或 WebView 的默认安全策略限制上。常见原因包括:

  • 网站依赖 DOM Storage(如 localStorage/sessionStorage)但未启用;
  • 网站通过 HTTP 重定向到带 www 的 HTTPS 地址,而原始 URL 缺少 www 导致重定向失败(尤其在较新 Android 版本中,WebView 对混合重定向和证书验证更严格);
  • 缺少必要 WebSettings 配置(如 setMixedContentMode、setAllowContentAccess 等,虽非本例主因,但建议一并检查)。

核心修复步骤(两步必做):

  1. 启用 DOM Storage
    在 onCreate() 中 webView.getSettings().setJavaScriptEnabled(true); 后添加:

    webView.getSettings().setDomStorageEnabled(true);

    ⚠️ 注意:DOM Storage 是现代 Web 应用(尤其是基于 React/Vue 或含登录态的站点)的必备支持,禁用会导致 JS 报错、页面无法渲染。

  2. 使用带 www 的完整域名 URL
    将:

    webView.loadUrl("https://softcommerceltd.com/");

    替换为:

    Android开发教程与笔记pdf版
    Android开发教程与笔记pdf版

    Android文件存取与数据库编程知识,文件操作主要是读文件、写文件、读取静态文件等,同时还介绍了创建添加文件内容并保存,打开文件并显示内容;数据库编程方面主要介绍了SQLite数据库的使用、包括创建、删除、打开数据库、非查询SQL操作指令、查询SQL指令-游标Cursors等知识。

    下载
    webView.loadUrl("https://www.softcommerceltd.com/");

    ✅ 原因:该网站很可能配置了从 softcommerceltd.com → www.softcommerceltd.com 的 301/302 重定向。Android WebView(尤其 Android 9+)对跨域重定向和证书链验证更严格,若原始 URL 与证书 Subject Alternative Name(SAN)不完全匹配(如证书仅包含 www.softcommerceltd.com),重定向可能被静默拦截,造成白屏。

? 补充建议(提升健壮性):
在 WebViewClient 中添加错误日志便于排查:

@Override
public void onReceivedError(WebView view, WebResourceRequest request, WebResourceError error) {
    super.onReceivedError(view, request, error);
    Log.e("WebView", "Load failed: " + error.getDescription() + ", Code: " + error.getErrorCode());
}

同时确认 AndroidManifest.xml 已声明网络权限(您已正确配置):

<uses-permission android:name="android.permission.INTERNET"></uses-permission>

? 验证方法:

  • 在 Chrome 浏览器中访问 https://softcommerceltd.com/ 和 https://www.softcommerceltd.com/,观察是否发生跳转(F12 → Network 标签查看重定向链);
  • 使用 SSL Labs 检查证书是否覆盖两个域名(softcommerceltd.com 和 www.softcommerceltd.com);若仅覆盖 www,则必须使用带 www 的 URL。

? 总结:WebView 白屏 ≠ 网站故障,而是客户端配置与服务端部署的协同问题。启用 DOM Storage + 使用证书匹配的完整域名(推荐 https://www.xxx.com),可解决 90% 的此类加载异常。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

android

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
android开发三大框架
android开发三大框架

android开发三大框架是XUtil框架、volley框架、ImageLoader框架。本专题为大家提供android开发三大框架相关的各种文章、以及下载和课程。

2023.08.14

751

4

android是什么系统
android是什么系统

Android是一种功能强大、灵活可定制、应用丰富、多任务处理能力强、兼容性好、网络连接能力强的操作系统。本专题为大家提供android相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.22

2058

5

android权限限制怎么解开
android权限限制怎么解开

android权限限制可以使用Root权限、第三方权限管理应用程序、ADB命令和Xposed框架解开。详细介绍:1、Root权限,通过获取Root权限,用户可以解锁所有权限,并对系统进行自定义和修改;2、第三方权限管理应用程序,用户可以轻松地控制和管理应用程序的权限;3、ADB命令,用户可以在设备上执行各种操作,包括解锁权限;4、Xposed框架,用户可以在不修改系统文件的情况下修改应用程序的行为和权限。

2023.09.19

3275

7

android重启应用的方法有哪些
android重启应用的方法有哪些

android重启应用有通过Intent、PendingIntent、系统服务、Runtime等方法。本专题为大家提供Android相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.18

361

5

Android语音播放功能实现方法
Android语音播放功能实现方法

实现方法有使用MediaPlayer实现、使用SoundPool实现两种。可以根据具体的需求选择适合的方法进行实现。想了解更多语音播放的相关内容,可以阅读本专题下面的文章。

2024.03.01

714

5

墨刀AI提示词教学
墨刀AI提示词教学

本合集由PHP中文网精心整理,为您提供全面的墨刀AI提示词教学。内容涵盖高质量原型撰写公式与实操窍门,助您轻松掌握AI设计工具。无论是零基础入门还是进阶技巧,都能让您快速上手,大幅提升产品设计与协作效率。

2026.08.04

4

21

墨刀AI完整入门
墨刀AI完整入门

PHP中文网为您倾力打造墨刀AI保姆级入门指南完整版!本合集从零基础讲起,涵盖AI生成原型、提示词优化、图片转原型及多轮对话等核心功能。无论您是新手还是进阶用户,都能轻松掌握产品设计全流程。快来PHP中文网,一键解锁高效设计技巧,让想法即刻成型!

2026.08.04

1

20

墨刀AI进阶技巧
墨刀AI进阶技巧

本合集由PHP中文网精心整理,为您提供墨刀AI核心进阶策略指南。内容涵盖高效提示词写作、原型智能生成与微调、结构化导图制作及行业分析报告输出等实战技巧。助您轻松掌握AI设计工具,大幅提升产品设计与团队协作效率。

2026.08.04

6

14

火山引擎实名认证失败怎么办
火山引擎实名认证失败怎么办

火山引擎实名认证失败可能与证件信息填写错误、姓名或企业信息不一致、证件照片不清晰、营业执照状态异常、手机号验证失败或审核资料不完整有关。本专题整理个人认证、企业认证、资料上传、审核退回、重新提交和认证不通过的常见处理方法。

2026.08.04

3

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Excel 教程
Excel 教程

共162课时 | 39.5万人学习

Java 教程
Java 教程

共578课时 | 172万人学习

Uniapp从零开始实现新闻资讯应用
Uniapp从零开始实现新闻资讯应用

共64课时 | 8.6万人学习