UniApp热更新失败：如何排查客户端代码、服务端配置及网络问题？-php教程-PHP中文网

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

霞舞

发布： 2025-03-01 23:42:23

原创

1170人浏览过

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参数赋值已修正。需要进一步检查以下方面：