修复背景:
账号注销成功后, 用户被重定向到 native 登录页 (手机号+验证码表单风格, 像 H5),
而不是微信小程序原生授权登录 (ns-login 弹窗 + getPhoneNumber 授权).
此外, 微信小程序下短时间内连发 reLaunch 会触发 native 错误:
appLaunch with non-empty page stack
以及历史遗留的 navigateTo push 登录页 + 旧页面在栈中导致的死循环问题.
主要修复:
1. util.js redirectTo reLaunch 分支 (4 平台兼容):
- H5 平台: window.location.replace (真正清空 history, 避免 history.back + router.replace 假清栈)
- 小程序平台 (mp-weixin/mp-harmony/...): 加 300ms 全局跳转锁 + setTimeout(0) 包裹
解决 appLaunch with non-empty page stack 错误
- APP/其他: 保留原生 uni.reLaunch
2. util.js redirectTo 入口智能默认 (跨平台兜底):
- 目标 == LOGIN_PAGE_URL && mode 是默认 navigateTo && 没传 back 参数
→ 自动改成 reLaunch (避免注销后死循环)
- 显式传 mode 或带 back 参数的场景保持原行为 (不影响登录后回原页面)
3. member-public.js mixin 增强:
- getLoginEntryUrl(): 跨平台登录入口智能分流
微信小程序/鸿蒙/其他小程序 → INDEX_PAGE_URL (首页, 走 ns-login 原生授权弹窗)
H5/快应用/APP → LOGIN_PAGE_URL (原生登录页)
- redirectToLoginOnce(): 统一封装 clearLoginState + 跳登录入口, 带 800ms 组件级防抖锁
- logout / getCancelStatus 兜底 / submitCancelApply 三个地方都改用 redirectToLoginOnce()
4. 5 个注销/退出流程页面改造:
- cancelsuccess.vue / cancelstatus.vue / cancellation.vue / cancelrefuse.vue
/ assets.vue: 跳登录入口全部用 redirectToLoginOnce (不再直接 redirectTo(LOGIN_PAGE_URL))
- cancellation.vue / cancelrefuse.vue: 加 memberPublic mixin (原本没有)
5. 取消了在 pages/index/public/js/index.js 中 onShow 自动弹登录弹窗的尝试
(因触发 Vue 框架的 dataset of null pre-existing 错误, 改由其他途径处理)
测试覆盖 (300+ 测试用例全部通过):
- tests/member-cancel-flow.test.js (28 个测试, 9 个用户故事场景)
- tests/redirectTo-relaunch-h5.test.js (11 个测试, 9 个跨平台场景)
- tests/redirectTo-real.test.js (12 个)
- tests/util.test.js (30 个)
- 其他 8 个测试文件全部通过
小程序及快应用前端源码
1. 📋 项目说明
该项目基于 uni-app 开发构建,请使用 HBuilderX 进行代码开发及构建发布。
2. 🛠️ 开发说明
- 源码基于 Vue2 版本
- SCSS 采用 dart-sass 进行编译输出
3. 🔧 开发调试说明
3.1 注意事项
- 应用访问等关键参数的配置来源于
./common/js/config.js
3.2 本地调试
.local.config.js.example 是本地调试配置示例。
拷贝 .local.config.js.example 为 .local.config.js 文件,默认开发调试模式会自动加载该文件
4. 📦 发布说明
4.1 小程序发布
4.1.1 基本操作步骤(通用版/定制化版)
##### ##### ##### 【前置准备】
- 在项目根目录打开终端安装依赖:
已有依赖可跳过此步骤
npm install
##### ##### ##### 【发布构建】
- 使用 HBuilderX 打开项目(不用改manifest.json的web,只有H5要改 )
- 选择菜单栏「发行」 → 「小程序-微信」→ 「发行」,等待构建完成 ⚠️ 注意:底部控制台弹出"请在微信小程序开发者工具中点击上传"后再执行下一步
- 构建完成后,自动执行补丁脚本(拷贝 site.js / config 文件 + 生成 ZIP 包),无需手动操作
- 找到项目根目录
/unpackage/dist/build下生成的 mp-weixin 压缩包 💡 示例:mp-weixin-2026-05-11-3bff91e.zip压缩包文件名末尾为 Git 提交 ID 同时该目录下会生成未压缩的mp-weixin目录
##### ##### ##### 【验证与重命名】
-
打开未压缩的
mp-weixin目录,找到site.js文件,将文件内的uniacid值改为当前客户编号(如:2812)并保存 -
打开微信开发者工具,导入「mp-weixin」目录,点击「编译」,在开发者工具控制台验证有无报错,以及能否返回对应客户的业务数据
-
确保无误后将生成的 mp-weixin 压缩包重命名
- 定制化版格式:
定制化-客户编号-域名-mp-weixin-当前日期-Git提交ID.zip - 通用版无需重命名
💡 示例:
custom-2812-xcx.aigc-quickapp.com-mp-weixin-2026-05-11-3bff91e.zip🚫 禁止:压缩包命名禁止包含
/ \ : * ? " < > |等特殊字符 - 定制化版格式:
##### ##### ##### 【交付与最终发布】🔍
- 将重命名后的文件发送给技术人员 📌通用版直接将生成的 mp-weixin 压缩包发送给技术人员
- 技术人员操作流程:
- 解压压缩包
- 确认
site.js中的uniacid为客户编号 - 用微信开发者工具导入解压后的代码目录
- 编译验证无误后,上传发布
4.1.2 鸿蒙小程序发布(mp-harmony)
##### ##### ##### 【发布构建】
- 使用 HBuilderX 打开项目
- 选择菜单栏「发行」 → 「HarmonyOS」→ 「发行」,等待构建完成
- 构建完成后,自动执行
harmony.patch.js补丁脚本(配置拷贝 + ZIP 打包) - 找到项目根目录
/unpackage/dist/build下生成的 mp-harmony 压缩包
##### ##### ##### 【交付与最终发布】🔍
- 将生成的
.zip文件发送给运维人员 - 运维人员操作流程:
- 解压压缩包
- 打开鸿蒙开发者工具,导入解压后的代码目录
- 验证代码无报错后,执行上传发布操作
##### ##### ##### 【本地设置】

4.2 快应用发布
4.2.1 基本操作(通用版/定制化版)
4.2.1.1 【发布构建】
-
使用 HBuilderX 打开项目
-
打开项目根目录的
manifest.json文件,切换至可视化配置界面:- 依次点击「Web 配置」→「运行的基础配置」
- 根据情况查看是否修改路径中/hwappx/????/的客户编号
📌 通用版保留原有
/hwappx/common/📌 测试版保留原有/hwappx/test/💡 个性化定制示例:/hwappx/2811/,其中 2811 为定制化版客户编号
-
选择菜单栏「发行」 → 「自定义发行」 → 选择对应的站点脚本 💡 例如:网址是
5g.aigc-quickapp.com选H5-5g.aigc-quickapp.com -
修改以下配置:
- 网站标题:快应用
- 网站域名:当前客户域名
- 确认后点击「发行」等待构建完成
⚠️ 注意:构建完成后自动输出到
unpackage/dist/build/h5/,格式为{域名}-{base路径}.zip💡 示例:xcx.aigc-quickapp.com-hwappx.common-3bff91e-20260511_1058.zip
4.2.1.2 【交付与最终发布】🔍
- 将生成的
.zip文件发送给运维人员 - 运维人员操作流程:
- 解压压缩包
- 打开快应用开发者工具,导入解压后的代码目录
- 验证代码无报错后,执行上传发布操作
4.2.1.3 【测试流程】
H5:打开自己的浏览器输入网址(https://5g.aigc-quickapp.com/hwappx/common/?uniacid=75)改站点 如果是test就把hwappx/common/改为hwappx/test/----------改站点
5. 📝 构建与版本信息
5.1 自动注入机制
生产构建时,vue.config.js 中的 VersionInjectPlugin 会自动执行以下操作:
| 操作 | 适用平台 | 说明 |
|---|---|---|
__app_version 全局变量注入 |
所有平台 | 构建产物的 vendor.js(小程序)或 index.html(H5)中自动内联版本数据 |
| 构建版本信息查看 | 所有平台 | 首页右下角连击 5 次弹出模态框显示 commitId 和 buildTime |
| 极限压缩优化 | 小程序(mp-weixin / mp-harmony) | 生产构建自动应用多层次压缩配置,显著减小产物包体积 |
版本数据包含:
- commitId:当前构建的 Git 短提交 ID
- buildTime:构建时间
开发模式:HMR 热更新时由 webpack emit 钩子自动处理,不影响开发体验。
5.2 自动 ZIP 打包
H5 自定义发行构建完成后自动执行:
| 步骤 | 说明 |
|---|---|
| 重命名输出目录 | {域名}-{base路径用.连接}(如 xcx.aigc-quickapp.com-hwappx.common) |
| 创建 ZIP 文件 | 文件名格式:{目录名}-{Git提交ID}-{上海时区时间戳}.zip |
| 清理 | ZIP 创建完成后自动删除源目录 |
💡 示例 ZIP:xcx.aigc-quickapp.com-hwappx.common-3bff91e-20260511_1058.zip
微信小程序生产构建时自动执行:
- 拷贝
site.js/project.config.json/project.private.config.json文件到构建目录 - 创建 ZIP 包(文件名包含 Git 提交 ID)
鸿蒙小程序生产构建时自动执行:
- 拷贝必要配置文件到构建目录
- 创建 ZIP 包(文件名包含 Git 提交 ID)
5.3 环境配置
域名配置统一通过 package.json 中各脚本的 env.UNI_APP_DOMAIN 传入:
"h5-xcx.aigc-quickapp.com": {
"title": "...",
"env": {
"UNI_PLATFORM": "h5",
"UNI_APP_DOMAIN": "https://xcx.aigc-quickapp.com/"
},
"define": { "PRODUCTION": true }
}
config.js 和 vue.config.js 均通过 process.env.UNI_APP_DOMAIN 读取,新增/删除脚本无需改动代码。
6. 🔄 版本历史
6.1 v1.5.1
VersionInjectPlugin:webpack emit 钩子自动注入__app_version到所有平台产物- 首页右下角连击 5 次显示构建版本信息(commitId + buildTime)
mp-weixin.patch.js精简为仅文件拷贝和 ZIP 打包- 新增
harmony.patch.js:鸿蒙小程序生产构建补丁脚本(配置拷贝 + ZIP 打包) open-directory.js:构建完成后自动打开输出目录- 极限压缩优化:集成
zion-uniapp-mp-load-package插件 + TerserWebpackPlugin 多层次压缩配置 - 修复
openWxWorkServiceChat方法中 fail 回调语法错误 - ZIP 文件名末尾使用 Git 提交 ID 替换时间戳
- 构建脚本幂等性修复,支持多次运行不产生重复注入
6.2 v1.3
- 修复微信小程序构建脚本,支持复制
project.config.json和project.private.config.json文件 - 增强构建脚本功能,添加命令行参数支持
- 在
package.json中添加相关 npm 脚本命令 - 优化脚本执行逻辑,提高可靠性和灵活性