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参数赋值已修正。 需要进一步检查以下方面：
-
服务器端WGT包路径: 验证
http://192.168.3.11:801/2109c97.wgt路径下WGT包是否存在且可访问。 -
网络连接: 确保模拟器能访问
http://192.168.3.11:801。 - 版本号校验: 仔细检查服务器端版本号校验逻辑，确保正确识别客户端版本并返回正确的更新状态和WGT包地址。
- 模拟器配置: 检查模拟器网络设置，确保没有阻止应用访问网络。
- WGT包构建: 检查生成的WGT包是否完整，是否符合UniApp热更新规范。
- 权限: 确认应用拥有必要的网络访问权限。
建议首先修正客户端代码，然后依次检查服务器端、网络连接及其他配置。 仔细检查服务器端的错误日志，这有助于快速定位问题。 确保服务器端返回的JSON数据格式正确。
