UniApp热更新失败：如何排查客户端代码、服务端配置及网络问题？

UniApp热更新失败：客户端、服务器及网络问题排查

UniApp的热更新功能对应用的持续维护至关重要。然而，热更新失败的情况时有发生，本文将通过一个案例，分析并解决UniApp热更新失效问题。

问题描述：

模拟器调试过程中，UniApp热更新无法生效，WGT包更新失败。

客户端代码 (onLaunch函数):

onLaunch: function() {
    const server = "http://192.168.3.11:801/updata.php"; //更新检查地址
    const req = { //升级检测数据
        appid: plus.runtime.appid,
        version: plus.runtime.version,
        name: plus.os.name
    };

    uni.request({
        url: server,
        data: req,
        success: (res) => {
            // 整包更新
            if (res.statusCode === 200 && res.data.status === 1) {
                uni.showModal({ //更新提示
                    title: "更新提示",
                    content: res.data.note,
                    success: (res1) => {
                        if (res1.confirm) {
                            plus.runtime.openURL(res.data.url);
                        }
                    }
                });
            }
            // 热更新
            if (res.statusCode === 200 && res.data.status === 2) {
                uni.downloadFile({
                    url: res.data.url,
                    success: (downloadResult) => {
                        if (downloadResult.statusCode === 200) {
                            plus.runtime.install(downloadResult.tempFilePath, { force: true }, () => {
                                console.log('安装成功');
                                plus.runtime.restart();
                            }, (e) => {
                                console.error('安装失败', e);
                            });
                        }
                    }
                });
            }
        }
    });
}

服务器端代码 (PHP):

header("Content-type:text/json");
$appid = $_GET["appid"];
$version = $_GET["version"]; //客户端版本号
$name = $_GET['name'];
$rsp = array("status" => 2); //默认：无需升级

if (isset($appid) && isset($version)) {
    if ($appid === "HBuilder") { //校验appid
        if ($version !== "1.0.1") { //示例，实际版本号应从数据库或配置文件获取

            $rsp["status"] = 2; //热更新
            if ($rsp["status"] == 1) { //整包更新
                $rsp["note"] = "修复bug1；\n修复bug2;";
                $rsp["url"] = ($name == "Android") ? "http://192.168.3.11:801/__UNI__41811EC_0824161936.apk" : "itms-apps://itunes.apple.com/cn/app/******";
            } else {
                $rsp["url"] = "http://192.168.3.11:801/2109C97.wgt"; //热更新包地址
            }
        }
    }
}
echo json_encode($rsp);
exit;

问题分析及解决方法：

客户端代码中uni.downloadFile的url参数赋值已修正。 需要进一步检查以下方面：

1. 服务器端WGT包路径: 验证http://192.168.3.11:801/2109c97.wgt路径下WGT包是否存在且可访问。
2. 网络连接: 确保模拟器能访问http://192.168.3.11:801。
3. 版本号校验: 仔细检查服务器端版本号校验逻辑，确保正确识别客户端版本并返回正确的更新状态和WGT包地址。
4. 模拟器配置: 检查模拟器网络设置，确保没有阻止应用访问网络。
5. WGT包构建: 检查生成的WGT包是否完整，是否符合UniApp热更新规范。
6. 权限: 确认应用拥有必要的网络访问权限。

建议首先修正客户端代码，然后依次检查服务器端、网络连接及其他配置。 仔细检查服务器端的错误日志，这有助于快速定位问题。 确保服务器端返回的JSON数据格式正确。