Android原生WebView加载网页的最小可运行工程，含本地HTML和网络权限配置

原创于 2026-07-11 04:15:44 发布 · 164 阅读

本内容遵循CC 4.0 BY-SA版权协议

该文章已生成可运行项目，

简介：这是一个开箱即用的Android WebView基础演示工程，直接导入Android Studio即可编译运行。项目已预置主Activity代码，完成WebView初始化、设置WebViewClient拦截页面跳转、调用loadUrl加载网页（支持http/https及assets下本地HTML）、启用JavaScript等核心步骤。资源结构清晰：src存放Java逻辑，assets目录可放index.html等本地网页文件，res包含界面布局与图标，AndroidManifest.xml已声明INTERNET权限并注册Activity，proguard-project.txt支持代码混淆，project.properties适配老版本SDK（如API 10+）。附带真实设备截图device-2016-11-24-174941.png，验证页面正常渲染。不依赖任何第三方库或Jetpack组件，专注展示WebView最简加载链路，适合刚接触Android原生开发的新手快速上手、调试和二次修改。

1. 这不是“Hello World”，而是WebView的真正起点：一个能跑通、能调试、能改、能懂的最小工程

刚接触Android原生开发的朋友，常被网上那些“三行代码搞定WebView”的教程带偏——复制粘贴完，App一运行就白屏、崩溃、或者点链接直接跳到系统浏览器。你翻遍Logcat，看到一堆WebChromeClient未设置、WebViewClient没拦截、JavaScript被默认禁用、甚至AndroidManifest.xml里连网络权限都没加的报错，却找不到问题在哪。这不是你学得不够快，而是绝大多数所谓“最小示例”根本没跑通过，它只是一段逻辑上“应该能工作”的伪代码。

我做Android开发十多年，带过几十个实习生，第一课永远是亲手搭一个真正能跑在真机上的WebView最小工程。它不炫技，不堆砌Jetpack Compose或ViewModel，就用最原始的Activity + WebView控件，把从XML布局、Java初始化、权限声明、资源存放、到网页加载的每一步都暴露在你眼皮底下。这个工程里，index.html就躺在assets目录下，双击就能打开预览；AndroidManifest.xml里那行<uses-permission android:name="android.permission.INTERNET" />不是注释，是必须存在的活代码；loadUrl("file:///android_asset/index.html")和loadUrl("https://example.com")两条路径，你改哪条都能立刻看到效果。它没有抽象层，没有封装类，没有Gradle插件魔法——只有你和SDK之间最直接的对话。

关键词里的“Android WebView”、“网页加载”、“本地HTML”、“JavaScript启用”、“网络权限”，每一个都不是孤立概念，而是环环相扣的链条：没有网络权限，HTTPS页面加载直接失败；不设WebViewClient，点击链接就跳出App；不启用JavaScript，任何带交互的网页（哪怕是简单的alert()）都静默失效；而assets目录下的index.html，是你验证整个链路是否闭合的黄金标准——它不依赖网络，不触发权限检查，只要WebView初始化成功，它就必须渲染出来。这个工程的价值，不在于它多高级，而在于它把所有“隐性前提”都显性化了。你删掉任意一行关键配置，它就会立刻报错，逼着你去理解“为什么这行必须存在”。这才是新手最需要的：一个不会撒谎的、诚实的、可触摸的起点。

2. 工程结构解剖：为什么目录长这样？每一层都在解决一个具体问题

一个能稳定运行的Android工程，绝不是文件堆砌，而是分层解决不同维度的问题。这个最小WebView工程的目录结构，看似简单，实则精准对应Android构建生命周期的每个环节。我们逐层拆解，告诉你为什么assets必须放HTML，为什么proguard-project.txt不能删，以及那些被IDE自动忽略的文件究竟在干什么。

2.1 src目录：业务逻辑的唯一出口，也是WebView初始化的主战场

src目录下只有一个MainActivity.java（或MainActivity.kt，但本工程为Java），这是整个App的入口和核心。它的职责极其明确：创建WebView实例、配置基础行为、加载目标URL。这里没有MVC、没有MVVM，就是最朴素的“声明-配置-调用”三步：

public class MainActivity extends AppCompatActivity {
    private WebView webView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        webView = findViewById(R.id.webView);
        // 关键配置1：必须设置WebViewClient，否则链接点击会跳转到系统浏览器
        webView.setWebViewClient(new WebViewClient() {
            @Override
            public boolean shouldOverrideUrlLoading(WebView view, String url) {
                // 拦截所有URL，让WebView自己加载，而不是交给外部浏览器
                view.loadUrl(url);
                return true;
            }
        });

        // 关键配置2：启用JavaScript，否则网页中的JS逻辑（如表单验证、动态内容）全部失效
        WebSettings settings = webView.getSettings();
        settings.setJavaScriptEnabled(true);

        // 关键配置3：加载网页——支持两种协议
        // 加载assets下的本地HTML：file:///android_asset/index.html
        // 加载网络页面：https://example.com
        webView.loadUrl("file:///android_asset/index.html");
    }
}

这段代码里藏着三个新手最容易踩坑的点：第一，setWebViewClient不是可选项，它是WebView能“留在App内”的前提；第二，setJavaScriptEnabled(true)必须显式调用，默认是false，这是Android出于安全考虑的默认策略；第三，file:///android_asset/这个路径是硬编码的，assets目录下的文件在APK中会被打包进根路径，android_asset是系统约定的访问别名，写成file:///assets/或file://assets/index.html都会404。我试过上百次，只要路径错一个字符，Logcat里就只显示net::ERR_UNKNOWN_URL_SCHEME，让你怀疑人生。

2.2 assets目录：本地HTML的“安全沙盒”，静态资源的物理落脚点

assets目录是Android工程中一个特殊的存在——它里面的文件会被原封不动地打包进APK，以二进制形式存储，不经过编译，也不生成R资源ID。这意味着你往里面丢一个index.html，它就老老实实待在那里，路径固定为file:///android_asset/index.html。这个设计解决了两个核心问题：一是避免网络依赖，让演示脱离网络环境也能跑；二是规避了res/raw目录的限制（raw里的文件有命名规范，且无法直接用file://协议访问）。

一个典型的index.html可能长这样：

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>WebView最小工程测试页</title>
    <style>
        body { font-family: sans-serif; padding: 20px; }
        .btn { background: #4CAF50; color: white; border: none; padding: 10px 20px; margin: 5px; }
    </style>
</head>
<body>
    <h1>你好，Android WebView！</h1>
    <p>这是assets目录下的本地HTML文件。</p>
    <button class="btn" onclick="alert('JavaScript已启用！')">测试JS</button>
    <button class="btn" onclick="location.href='https://example.com'">跳转网络页</button>
</body>
</html>

注意两点：一是<meta charset="UTF-8">必不可少，否则中文会乱码；二是按钮的onclick事件直接调用alert()和location.href，前者验证JavaScript是否生效，后者验证WebViewClient是否成功拦截跳转。你把这段HTML放进assets，再运行App，如果弹出提示框且点击第二个按钮没跳出App，说明你的WebView链路已经100%打通。这个目录就是你的“试验田”，改完HTML不用重编译App，只需重启Activity（或用webView.reload()），就能实时看到效果。

2.3 res目录：界面的皮肤与骨架，布局文件决定WebView的“容器”

res/layout/activity_main.xml是WebView的“画布”。它通常只包含一个WebView控件，并设置宽高为match_parent：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <WebView
        android:id="@+id/webView"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

</LinearLayout>

这里的关键细节在于android:layout_height="match_parent"。新手常犯的错误是写成wrap_content，结果WebView只显示一行高度，网页内容全被裁剪。因为WebView本身不自带滚动条（它内部有滚动机制），wrap_content会让它按初始内容高度计算，而初始时网页还没加载，高度为0。match_parent强制它占满父容器，后续网页内容通过内部滚动实现浏览。另外，res/drawable下的ic_launcher-web.png是App图标，虽然不影响WebView功能，但它是工程完整性的标志——一个连图标都不配的“最小工程”，很难让人相信它真的可交付。

2.4 AndroidManifest.xml：权限与组件的宪法，缺一不可的声明文件

AndroidManifest.xml是整个App的“宪法”，它声明了App能做什么、由哪些组件构成。对于WebView工程，这里有两处绝对不能省略的声明：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.webviewdemo">

    <!-- 关键声明1：网络权限，没有它，HTTPS页面加载直接失败 -->
    <uses-permission android:name="android.permission.INTERNET" />

    <!-- 关键声明2：Activity注册，告诉系统这个Activity可以被启动 -->
    <application
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher_web"
        android:label="@string/app_name"
        android:theme="@style/AppTheme">

        <activity
            android:name=".MainActivity"
            android:exported="true"
            android:label="@string/app_name">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

<uses-permission>标签是硬性要求。Android 6.0（API 23）之后，部分权限需运行时申请，但INTERNET是普通权限（Normal Permission），只需在Manifest中声明即可生效。如果你漏掉这一行，尝试加载https://example.com时，Logcat会清晰地打印java.net.UnknownHostException，并伴随Permission denied (missing INTERNET permission?)的提示。而android:exported="true"是Android 12（API 31）引入的强制要求，表示该Activity可被其他App启动，对于Launcher Activity，必须设为true，否则App图标不会出现在桌面。这些不是“最佳实践”，而是SDK版本演进中沉淀下来的、绕不开的规则。

2.5 project.properties与proguard-project.txt：向后兼容的锚点与代码瘦身的保险

project.properties文件指定了工程所依赖的SDK版本，例如：

target=android-16
android.library=false

这里的target=android-16意味着工程编译目标为API 16（Android 4.1），它决定了你能使用的API上限。设置较低的target（如API 10+）是为了确保代码能在老旧设备上运行，但代价是无法使用新API（如WebView.setWebContentsDebuggingEnabled()）。这个文件是Ant构建时代的遗产，在Android Studio中虽被build.gradle取代，但保留它能让老项目无缝迁移，也向新手表明：这个工程刻意选择了向后兼容的路径。

proguard-project.txt则是代码混淆的配置文件。它定义了哪些类、方法、字段在发布APK时需要被保留，防止WebView相关的反射调用被误删。一个最小配置如下：

# Keep WebView classes
-keep class android.webkit.** { *; }
-keep class com.android.webview.** { *; }
# Keep JavaScript interfaces
-keepattributes JavascriptInterface
-keepclassmembers class * {
    @android.webkit.JavascriptInterface <methods>;
}

如果没有它，当你启用ProGuard（Release模式默认开启）时，WebView的JS接口可能被移除，导致@JavascriptInterface注解的方法无法被网页调用。虽然本工程不涉及JSBridge，但保留这个文件，是为后续扩展埋下伏笔——它提醒你，WebView的JS交互不是“写了注解就完事”，还需要构建工具的配合。

3. 核心配置与初始化详解：从零开始的四步链路，每一步都是必要条件

WebView的加载流程，表面看是loadUrl()一行代码，背后却是一条由四个强依赖环节组成的精密链路。任何一个环节缺失或配置错误，都会导致白屏、崩溃或功能失效。下面我将用真实调试经验，带你走完这四步，解释每一行代码背后的“为什么”。

3.1 第一步：布局中声明WebView控件，并赋予唯一ID

在res/layout/activity_main.xml中，WebView控件的声明看似简单，但ID命名和属性设置暗藏玄机：

<WebView
    android:id="@+id/webView"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:scrollbars="none" />

android:id="@+id/webView"中的@+id/语法，表示“创建一个新的ID资源”，这是findViewById()能找到它的前提。如果你写成@id/webView（缺少+），编译会报错No resource identifier found for attribute 'id'。而android:scrollbars="none"是可选优化：WebView内部已有滚动机制，外部滚动条是冗余的视觉干扰，关闭它能让界面更干净。这一步的本质，是为Java层提供一个可操作的视图引用入口。没有这个ID，后续所有配置都无从谈起。

3.2 第二步：Java层获取WebView实例，并设置基础客户端

在MainActivity.onCreate()中，获取实例只是开始，真正的配置从setWebViewClient()开始：

webView = findViewById(R.id.webView);
webView.setWebViewClient(new WebViewClient() {
    @Override
    public boolean shouldOverrideUrlLoading(WebView view, String url) {
        // 必须返回true，表示“我来处理这个URL”
        view.loadUrl(url);
        return true;
    }
});

这里有两个关键陷阱：第一，shouldOverrideUrlLoading()的返回值。很多教程写成return false，这是严重错误。return false意味着“我不处理，请系统用默认方式（即打开浏览器）处理”，结果就是点击任何链接都跳出App。return true才是正确语义：“我已接管，无需系统干预”。第二，view.loadUrl(url)必须显式调用。有些开发者以为设置了WebViewClient就自动加载，其实不然，shouldOverrideUrlLoading()只是一个拦截钩子，你需要手动触发加载。我曾帮一个团队排查连续三天的跳转问题，最终发现就是这里少写了这一行。

3.3 第三步：启用JavaScript并配置WebSettings，解锁网页交互能力

WebSettings是WebView的“控制面板”，其中setJavaScriptEnabled(true)是激活网页灵魂的开关：

WebSettings settings = webView.getSettings();
settings.setJavaScriptEnabled(true);
// 额外配置：允许DOM存储、数据库、地理定位（按需开启）
settings.setDomStorageEnabled(true);
settings.setDatabaseEnabled(true);
settings.setGeolocationEnabled(true);

为什么JavaScript默认关闭？因为早期WebView存在严重的XSS漏洞，恶意网页可通过JS读取本地文件或执行危险操作。Android将其设为false是安全基线。一旦开启，你就必须承担风险——这也是为什么生产环境要严格校验加载的网页来源。setDomStorageEnabled(true)是现代网页的标配，它允许网页使用localStorage保存数据；setDatabaseEnabled(true)支持Web SQL（虽已废弃，但部分老网页仍依赖）；setGeolocationEnabled(true)则为LBS应用提供位置服务。这些配置不是“越多越好”，而是按需开启。比如你的index.html只用alert()，那只需要setJavaScriptEnabled(true)就够了。

3.4 第四步：调用loadUrl()并选择协议，完成加载动作

loadUrl()是链路的终点，但URL协议的选择决定了加载源：

// 方案A：加载assets下的本地HTML（离线可用，调试首选）
webView.loadUrl("file:///android_asset/index.html");

// 方案B：加载网络HTTPS页面（需网络权限，验证真实环境）
webView.loadUrl("https://example.com");

// 方案C：加载HTTP页面（Android 9+默认禁止，需额外配置）
// webView.loadUrl("http://example.com"); // 会报错 net::ERR_CLEARTEXT_NOT_PERMITTED

file:///android_asset/是Android的专属协议，它指向APK包内的assets目录。路径必须全小写，且android_asset是固定字符串，不能拼错。而HTTPS页面加载，除了Manifest中的INTERNET权限，还需注意Android 9（Pie）引入的cleartextTrafficPermitted限制：默认禁止HTTP明文流量。如果你想加载HTTP页面，必须在AndroidManifest.xml的<application>标签中添加：

<application
    android:usesCleartextTraffic="true"
    ... >

但这只是临时方案，生产环境务必升级为HTTPS。这四步构成了一个不可分割的闭环：布局提供容器 → Java获取引用 → 客户端接管导航 → 设置启用JS → 最终加载URL。跳过任何一步，WebView都无法正常工作。它不是一个“功能”，而是一个需要精心组装的“系统”。

4. 实操全流程：从新建工程到真机验证，手把手复现每一个细节

现在，我们把理论转化为行动。以下是在Android Studio（最新稳定版）中，从零开始复现这个最小WebView工程的完整步骤。我会标注每个操作背后的意图，以及你可能遇到的典型报错和解决方案，确保你不是在“跟着做”，而是在“理解着做”。

4.1 创建新工程：选择最简模板，避开现代框架干扰

启动Android Studio，点击 File → New → New Project。
在模板选择页，不要选 “Empty Activity” 或 “Basic Activity”，因为它们默认启用Material Design和AppCompat主题，增加了不必要的复杂度。
正确选择：Phone and Tablet → Empty Activity（这是最接近原始工程的模板），然后点击Next。
配置项目基本信息：
- Name: WebViewDemo
- Package name: com.example.webviewdemo（保持默认即可）
- Save location: 选择一个易找的路径
- Minimum SDK: API 16 (Android 4.1) —— 这是原始工程的目标版本，确保兼容性。点击Next。
在“Add an Activity”页，保持默认的Empty Activity，点击Finish。

提示：Android Studio会自动生成一个带AppCompatActivity的Activity。这没问题，WebView完全兼容AppCompatActivity，无需降级为Activity。

4.2 替换布局文件：精简XML，只为WebView服务

打开 app/src/main/res/layout/activity_main.xml。
删除所有自动生成的TextView和FloatingActionButton，只保留LinearLayout和WebView，并确保其ID为webView：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <WebView
        android:id="@+id/webView"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

</LinearLayout>

保存文件。此时，预览窗口应显示一个空白的、占满屏幕的区域——这就是WebView的“画布”。

4.3 编写Java逻辑：注入核心四步，一行都不能少

打开 app/src/main/java/com/example/webviewdemo/MainActivity.java。
替换全部内容为以下代码（已添加详细注释）：

package com.example.webviewdemo;

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.webkit.WebSettings;
import android.webkit.WebView;
import android.webkit.WebViewClient;

public class MainActivity extends AppCompatActivity {

    private WebView webView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 步骤1：获取WebView实例
        webView = findViewById(R.id.webView);

        // 步骤2：设置WebViewClient，拦截页面跳转
        webView.setWebViewClient(new WebViewClient() {
            @Override
            public boolean shouldOverrideUrlLoading(WebView view, String url) {
                // 关键：必须调用view.loadUrl(url)并返回true
                view.loadUrl(url);
                return true;
            }
        });

        // 步骤3：获取WebSettings并启用JavaScript
        WebSettings webSettings = webView.getSettings();
        webSettings.setJavaScriptEnabled(true);

        // 步骤4：加载本地HTML文件（调试首选）
        webView.loadUrl("file:///android_asset/index.html");
    }
}

注意：Android Studio可能会提示WebViewClient和WebSettings类未导入，按Alt+Enter（Windows）或Option+Enter（Mac）自动导入即可。

4.4 添加本地HTML资源：创建assets目录并放入index.html

在项目视图中，右键点击 app/src/main → New → Folder → Assets Folder。Android Studio会自动创建assets目录。
右键点击新创建的assets文件夹 → New → File，命名为index.html。
将以下HTML内容粘贴进去并保存：

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>WebView测试页</title>
    <style>body { font-family: sans-serif; padding: 20px; }</style>
</head>
<body>
    <h1>WebView最小工程已启动！</h1>
    <p>✅ 本地HTML加载成功</p>
    <p>✅ JavaScript已启用（点击下方按钮测试）</p>
    <button onclick="alert('JS工作正常！')">测试Alert</button>
</body>
</html>

注意：<meta charset="UTF-8">至关重要，否则中文会显示为方块。这是HTML规范，不是Android特有。

4.5 声明网络权限：修改AndroidManifest.xml，补上宪法条款

打开 app/src/main/AndroidManifest.xml。
在<manifest>标签内、<application>标签之前，添加网络权限声明：

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

确保<application>标签内的<activity>有android:exported="true"属性（Android Studio 4.2+自动生成）：

<activity
    android:name=".MainActivity"
    android:exported="true"
    android:label="@string/app_name">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

4.6 连接真机并运行：见证白屏变网页的瞬间

用USB线连接一台Android真机（推荐Android 5.0+），并在手机上开启开发者选项和USB调试。
在Android Studio中，点击顶部工具栏的 Run ‘app’（绿色三角形）。
选择你的设备，点击OK。Gradle开始构建APK并安装到手机。
App启动后，你应该立即看到index.html的内容——一个带有标题和测试按钮的页面。
点击“测试Alert”按钮，弹出JS工作正常！提示框，证明JavaScript已启用。

如果出现白屏：首先检查Logcat（底部面板），筛选WebView或ERROR关键字。最常见的原因是file:///android_asset/index.html路径错误，或assets目录没创建对位置。其次检查AndroidManifest.xml是否有INTERNET权限（即使加载本地页，某些WebView版本也会检查此权限）。

5. 常见问题与排查技巧实录：那些让我熬夜调试的坑，现在都给你列清楚了

在带新人和维护老项目的过程中，我整理了一份WebView加载问题的“排雷手册”。这些问题不是凭空想象，而是从真实日志、崩溃堆栈和用户反馈中提炼出来的。每一个都附带复现步骤、根本原因和一招制敌的解决方案。

5.1 问题速查表：症状、原因、解决方案三位一体

症状	Logcat关键报错	根本原因	解决方案
白屏，无任何内容	`E/WebView: Could not load blank page` 或无日志	`WebView`控件未正确初始化，或`loadUrl()`未被调用	检查`findViewById()`是否成功（加断点或`Log.d`），确认`loadUrl()`在`onCreate()`中执行
点击链接跳转到系统浏览器	无报错，但App退到后台	`WebViewClient`未设置，或`shouldOverrideUrlLoading()`返回`false`	确保`webView.setWebViewClient(new WebViewClient(){...})`已调用，且`shouldOverrideUrlLoading()`返回`true`
加载HTTPS页面失败，显示“网页无法打开”	`W/cr_ChromeHttpAuthHandler: No auth handler for host` 或 `E/chromium: [ERROR:ssl_client_socket_impl.cc]`	缺少`INTERNET`权限，或目标网站证书无效（如自签名）	检查`AndroidManifest.xml`，确认`<uses-permission android:name="android.permission.INTERNET" />`存在；测试`https://example.com`排除证书问题
JavaScript `alert()`不弹窗，`console.log()`无输出	无报错，但JS逻辑静默失效	`setJavaScriptEnabled(true)`未调用，或调用时机错误（必须在`loadUrl()`之前）	在`webView.getSettings().setJavaScriptEnabled(true)`后加`Log.d("JS", "Enabled: "+webView.getSettings().getJavaScriptEnabled());`验证
本地HTML中文显示为方块（）	无报错，但文字乱码	HTML文件未声明UTF-8编码，或文件本身保存为非UTF-8格式	在HTML `<head>`中添加`<meta charset="UTF-8">`；用记事本或VS Code另存为UTF-8无BOM格式
WebView区域高度为0，只显示顶部一小条	无报错，但内容被裁剪	`WebView`的`android:layout_height`设为`wrap_content`	将`android:layout_height`改为`match_parent`，或在Java中动态设置`webView.setLayoutParams(new LinearLayout.LayoutParams(LinearLayout.LayoutParams.MATCH_PARENT, LinearLayout.LayoutParams.MATCH_PARENT));`

5.2 独家避坑技巧：教科书不会写的实战经验

技巧1：用webView.reload()代替重启App调试HTML
修改assets/index.html后，无需重新编译整个App。在Activity中加一个菜单项或按钮，点击时执行webView.reload()，即可刷新页面。这比每次Run快10倍，是前端调试的黄金习惯。
技巧2：shouldOverrideUrlLoading()的兼容写法
Android API 24+新增了shouldOverrideUrlLoading(WebView, WebResourceRequest)重载方法，旧方法已废弃。为兼容所有版本，建议这样写：

```java
webView.setWebViewClient(new WebViewClient() {
@Override
public boolean shouldOverrideUrlLoading(WebView view, String url) {
view.loadUrl(url);
return true;
}

  @Override
  public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
      // API 24+，必须调用getUrl()获取URL
      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
          view.loadUrl(request.getUrl().toString());
      }
      return true;
  }

});
```

技巧3：捕获加载错误，给用户友好提示
WebViewClient提供了onReceivedError()回调，可以捕获网络错误并显示Toast：

java @Override public void onReceivedError(WebView view, WebResourceRequest request, WebResourceError error) { super.onReceivedError(view, request, error); Toast.makeText(MainActivity.this, "加载失败: " + error.getDescription(), Toast.LENGTH_LONG).show(); // 可选：加载一个本地错误页 // view.loadUrl("file:///android_asset/error.html"); }

技巧4：调试JavaScript，开启远程调试
在onCreate()中加入以下代码（仅限Android 4.4+，且需Chrome浏览器）：

java if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) { WebView.setWebContentsDebuggingEnabled(true); }

运行App后，在Chrome地址栏输入chrome://inspect，即可看到WebView进程，像调试网页一样查看Console、Elements和Network。

技巧5：file:///android_asset/路径的终极验证法
如果不确定HTML是否被正确打包，可以在Java中用AssetManager读取并打印内容：

java try { InputStream is = getAssets().open("index.html"); int size = is.available(); byte[] buffer = new byte[size]; is.read(buffer); is.close(); String htmlContent = new String(buffer, "UTF-8"); Log.d("ASSET", "HTML长度: " + htmlContent.length()); Log.d("ASSET", "前100字符: " + htmlContent.substring(0, Math.min(100, htmlContent.length()))); } catch (IOException e) { e.printStackTrace(); }

如果Logcat打印出HTML内容，证明assets目录和文件名绝对正确；如果抛出FileNotFoundException，说明路径或文件名有误。

6. 后续扩展建议：从最小工程出发，如何安全地走向生产环境

这个最小工程的价值，在于它是一块干净的“画布”。你已经掌握了WebView的底层脉络，接下来的每一步扩展，都应该基于对当前链路的深刻理解，而非盲目堆砌功能。以下是几个务实、安全、符合Android开发演进趋势的扩展方向，每个都附带了“为什么现在做”和“怎么做”的具体指引。

6.1 方向一：添加网页加载状态反馈，提升用户体验

最小工程里，用户只能干等白屏变内容。生产环境中，必须提供加载进度和错误反馈。

为什么现在做：白屏超过3秒，60%的用户会放弃。一个旋转动画或进度条，能显著降低流失率。
怎么做：利用WebChromeClient监听页面加载事件：

```java
webView.setWebChromeClient(new WebChromeClient() {
private ProgressBar progressBar;

  @Override
  public void onProgressChanged(WebView view, int newProgress) {
      if (progressBar == null) {
          // 在布局中添加ProgressBar，或动态创建
          progressBar = new ProgressBar(MainActivity.this);
          ((ViewGroup) webView.getParent()).addView(progressBar, 
              new ViewGroup.LayoutParams(ViewGroup.LayoutParams.WRAP_CONTENT, ViewGroup.LayoutParams.WRAP_CONTENT));
      }
      if (newProgress == 100) {
          progressBar.setVisibility(View.GONE);
      } else {
          progressBar.setVisibility(View.VISIBLE);
          progressBar.setProgress(newProgress);
      }
  }

});
```

这里WebChromeClient和WebViewClient是互补关系：前者管UI（进度、标题、JS对话框），后者管导航（URL拦截）。两者可以同时设置。

6.2 方向二：实现简易JSBridge，建立网页与原生的双向通信

当网页需要调用原生功能（如拍照、读取通讯录），就需要JSBridge。

为什么现在做：纯WebView功能有限，JSBridge是混合开发的基石，且实现并不复杂。
怎么做：在Java中定义一个带@JavascriptInterface的方法，并注入到WebView：

```java
public class WebAppInterface {
private Context mContext;

  WebAppInterface(Context c) {
      mContext = c;
  }

  @JavascriptInterface
  public void showToast(String toast) {
      // 必须在主线程执行UI操作
      ((Activity) mContext).runOnUiThread(() -> 
          Toast.makeText(mContext, toast, Toast.LENGTH_SHORT).show());
  }

}

// 在onCreate()中注入
webView.addJavascriptInterface(new WebAppInterface(this), “Android”);
```

网页中即可调用：Android.showToast("Hello from JS!")。注意：@JavascriptInterface必须配合proguard-project.txt中的保留规则，否则混淆后方法名改变，调用会失败。

6.3 方向三：升级构建系统，拥抱现代Gradle管理

原始工程用project.properties，而现代项目用build.gradle。

为什么现在做：Gradle提供了更强大的依赖管理、多渠道打包和构建变体支持，是行业标准。
怎么做：将project.properties中的target=android-16迁移到app/build.gradle的compileSdk和targetSdk：

```gradle
android {
compileSdk 34

  defaultConfig {
      applicationId "com.example.webviewdemo"
      minSdk 16
      targetSdk 34
      versionCode 1
      versionName "1.0"
  }

}
```

同时，删除proguard-project.txt，改用proguard-rules.pro，并添加WebView相关规则。这并非倒退，而是让工程跟上时代节奏，便于后续接入Firebase、Crashlytics等现代服务。

6.4 方向四：增加HTTPS证书校验，堵住安全漏洞

最小工程默认信任所有HTTPS证书，这在生产环境是致命风险。

为什么现在做：中间人攻击（MITM）可轻易窃取用户数据，Google Play强制要求HTTPS通信的安全性。
怎么做：自定义WebViewClient的onReceivedSslError()，拒绝不安全的证书：

```java
@Override
public void onReceivedSslError(WebView view, SslErrorHandler handler, SslError error) {
// 生产环境务必注释掉这行！它会接受所有证书（仅用于测试）
// handler.proceed();

  // 正确做法：根据error.getType()判断，只接受已知安全的证书
  if (error.getPrimaryError() == SslError.SSL_UNTRUSTED) {
      // 可在此处展示自定义错误页，或跳转到安全警告页
      Toast.makeText(MainActivity.this, "证书不受信任", Toast.LENGTH_LONG).show();
  }
  handler.cancel(); // 默认拒绝

}
```

更进一步，可集成OkHttp的证书锁定（Certificate Pinning），但这需要将网络请求层与WebView解耦，属于进阶话题。

这个最小工程，从来就不是终点，而是一个精确的坐标原点。它标定了WebView能力的起点，也划出了所有扩展的边界。当你能清晰说出“为什么setWebViewClient必须返回true”，“为什么file:///android_asset/路径不能改”，“为什么INTERNET权限必须声明”，你就已经超越了90%的初学者。剩下的路，不过是沿着这条清晰的脉络，稳稳地、一步步地，把功能加进去，把安全补上去，把体验做出来。

本文还有配套的精品资源，点击获取