From ce1e2bd4dda261907963ec1fa137fcb77f6c0892 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=B5=B5=E5=BF=A0=E6=9E=97?= <170083662@qq.com> Date: Thu, 16 Jul 2026 01:40:16 +0800 Subject: [PATCH] =?UTF-8?q?refactor(privacy):=20=E8=B0=83=E6=95=B4?= =?UTF-8?q?=E9=9A=90=E7=A7=81=E6=8E=88=E6=9D=83=E8=A7=A6=E5=8F=91=E9=80=BB?= =?UTF-8?q?=E8=BE=91=EF=BC=8C=E7=99=BB=E5=BD=95=E9=A1=B5=E5=8F=96=E6=B6=88?= =?UTF-8?q?=E4=B8=BB=E5=8A=A8=E9=A2=84=E6=A3=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 移除登录页和注册页 `useDidShow` 中主动调用 `ensurePrivacyAuthorized()` 预检的逻辑 - 登录页不再主动弹出隐私协议弹窗，由微信在用户点击手机号登录按钮时强制触发授权 - 门店订单管理页面调用 `chooseProofImage` 前新增 `ensurePrivacyAuthorized()` 预检，确保上传凭证时授权 - 修改隐私弹窗文案为更通用描述，避免误导用户以为是相册授权 - 保留全局 `onNeedPrivacyAuthorization` 通过 `PrivacyModal` 处理，适配微信基础库强制机制 - 统一门店商品管理上传使用已内置预检的 `uploadFile()` 接口调用流程 --- .workbuddy/memory/2026-07-16.md | 15 +++++++++++++++ .workbuddy/memory/MEMORY.md | 6 +++--- overview.md | 19 +++++++++++++++---- src/components/PrivacyModal/index.tsx | 2 +- src/pages/store/orders/index.tsx | 10 +++++++++- src/passport/login.tsx | 11 +---------- src/passport/register.tsx | 11 +---------- 7 files changed, 45 insertions(+), 29 deletions(-) diff --git a/.workbuddy/memory/2026-07-16.md b/.workbuddy/memory/2026-07-16.md index 918c8e3..9f27fac 100644 --- a/.workbuddy/memory/2026-07-16.md +++ b/.workbuddy/memory/2026-07-16.md @@ -35,3 +35,18 @@ - 后续提醒： - 由于之前的 `showModal` 授权无效，用户可能需要清理开发者工具/真机缓存后重新进入小程序，才能触发新的 PrivacyModal。 - 仍需在小程序后台添加「手机号」隐私声明，并确认手机号快速验证组件已开通、额度充足。 + +## 调整隐私授权触发位置：登录页不再主动预检，仅在门店上传图片时触发 + +- 用户反馈：隐私授权框不应在手机号登录时主动弹出，应只在门店中心上传图片/拍照时弹出。 +- 修改文件： + - `src/passport/login.tsx`：移除 `useDidShow` 中主动调用 `ensurePrivacyAuthorized()` 的逻辑；删除对应 import。 + - `src/passport/register.tsx`：同样移除 `useDidShow` 中的隐私预检；删除对应 import。 + - `src/components/PrivacyModal/index.tsx`：将弹窗文案改为更通用表述，避免用户误以为是相册授权。 + - `src/pages/store/orders/index.tsx`：在 `chooseProofImage` 调用 `Taro.chooseImage` 前增加 `ensurePrivacyAuthorized()` 预检（该页面直接调 chooseImage，不走 `uploadFile`）。 +- 保留逻辑： + - `src/app.tsx` 全局 `onNeedPrivacyAuthorization` 仍通过 `PrivacyModal` 处理，这是微信基础库 3.16.1+ 强制机制，无法移除。 + - `src/api/system/file/index.ts` 的 `uploadFile()` 内部已调用 `ensurePrivacyAuthorized()`，门店商品管理上传图片时会自动触发隐私授权。 +- 说明：登录时若用户尚未同意隐私协议，微信仍会在点击 `getPhoneNumber` 按钮时强制触发 `onNeedPrivacyAuthorization`。这是微信机制，无法避免；但进入登录页本身不会再主动弹框。 +- 验证：待构建完成。 + diff --git a/.workbuddy/memory/MEMORY.md b/.workbuddy/memory/MEMORY.md index 4dd1d7c..bff8d0d 100644 --- a/.workbuddy/memory/MEMORY.md +++ b/.workbuddy/memory/MEMORY.md @@ -50,13 +50,13 @@ ## 微信隐私协议（基础库 3.16.1+ 强制） - 报错特征：`chooseImage:fail api scope is not declared in the privacy agreement` / `getPhoneNumber:fail ... privacy ...` + `errno:112` - 代码修复： - 1. 调用 `Taro.chooseImage` / `getPhoneNumber` 等敏感 API 前，先 `getPrivacySetting` → `requirePrivacyAuthorize` 预检（封装在 `src/api/system/file/index.ts` 的 `ensurePrivacyAuthorized()` 里，已 export） + 1. 调用 `Taro.chooseImage` / `chooseMedia` / `getPhoneNumber` 等敏感 API 前，先 `getPrivacySetting` → `requirePrivacyAuthorize` 预检（封装在 `src/api/system/file/index.ts` 的 `ensurePrivacyAuthorized()` 里，已 export）。**注意**：不应在登录页 `useDidShow` 中主动预检，避免用户一进入登录页就弹框；应由微信在用户点击 `getPhoneNumber` 时自行触发 `onNeedPrivacyAuthorization`。 2. `src/app.tsx` 的 `useLaunch` 中注册 `Taro.onNeedPrivacyAuthorization` 回调，并通过 `src/components/PrivacyModal` 展示隐私协议授权弹窗。弹窗内的 Button 必须设置 `open-type="agreePrivacyAuthorization"`，用户点击后触发 `onAgreePrivacyAuthorization` 再 `resolve({ event: 'agree', button: 'agree' })`；`Taro.showModal` 的按钮无法被微信识别为有效的隐私授权 - 3. 登录/注册页在 `useDidShow` 中主动预检隐私协议，避免点击授权按钮时因未授权隐私协议而失败 + 3. 门店上传图片页面在调用 `chooseImage` 前主动预检：`src/pages/store/orders/index.tsx` 的 `chooseProofImage` 已加 `ensurePrivacyAuthorized()`；`src/pages/store/goods/index.tsx` 通过 `uploadFile()` 上传，`uploadFile()` 内部已预检。 - 手动配置：**小程序管理后台** → 设置 → 第三方设置 → 用户隐私保护指引 → 添加「开发者收集你的相册/摄像头」和「手机号」声明 - ⚠️ **`requiredPrivateInfos` 字段只接受位置类 API 白名单**（chooseAddress/chooseLocation/choosePoi/getFuzzyLocation/getLocation/onLocationChange/startLocationUpdate/startLocationUpdateBackground），不要加 `chooseImage`/`chooseMedia`/`getPhoneNumber` 等非位置类，会导致 app.json 解析失败 - 直接调 `Taro.chooseImage` 的页面：`pages/order/evaluate/index.tsx`、`pages/after-sale/apply/index.tsx`、`pages/store/orders/index.tsx` —— 这些页面绕过了 `uploadFile`，需要单独加 `ensurePrivacyAuthorized` 预检 -- 直接调 `getPhoneNumber` 的页面：`passport/login.tsx`、`passport/register.tsx` —— 已增加隐私协议预检 + 降级短信登录 +- 直接调 `getPhoneNumber` 的页面：`passport/login.tsx`、`passport/register.tsx` —— 不再主动预检，依赖微信点击按钮时自动触发 `onNeedPrivacyAuthorization`；保留降级短信登录 - 隐私授权弹窗组件：`src/components/PrivacyModal/index.tsx`（全局单例，通过 `src/utils/privacy.ts` 管理显隐与 resolve） ## 手机号授权登录降级方案（2026-07-15 ~ 07-16 修复） diff --git a/overview.md b/overview.md index 72321a9..3e6f818 100644 --- a/overview.md +++ b/overview.md @@ -6,14 +6,19 @@ - 原代码在 `onNeedPrivacyAuthorization` 中直接 `resolve({ event: 'agree' })`，在基础库 3.16.1+ 下无法通过微信校验。 - 新增 `src/components/PrivacyModal`，使用原生 Button 的 `open-type="agreePrivacyAuthorization"` 触发真正的隐私授权；`Taro.showModal` 的按钮无法被微信识别。 -2. **登录/注册页预检隐私协议** - - `src/passport/login.tsx` 和 `src/passport/register.tsx` 在 `useDidShow` 中调用 `ensurePrivacyAuthorized()`，避免用户点击授权按钮时因隐私协议未授权而失败。 +2. **登录/注册页不再主动预检隐私协议** + - 移除 `src/passport/login.tsx` 和 `src/passport/register.tsx` 中 `useDidShow` 主动调用 `ensurePrivacyAuthorized()` 的逻辑。 + - 进入登录页本身不再主动弹出隐私授权框；仅在用户点击手机号登录按钮，且微信检测到未授权时，才由微信强制触发 `onNeedPrivacyAuthorization`。 -3. **统一接口调用** +3. **门店中心上传图片前预检隐私协议** + - 门店商品管理（`src/pages/store/goods/index.tsx`）通过 `uploadFile()` 上传图片，该接口内部已调用 `ensurePrivacyAuthorized()`，点击上传时自动触发隐私授权。 + - 门店订单管理（`src/pages/store/orders/index.tsx`）直接调用 `Taro.chooseImage` 上传凭证，已在其 `chooseProofImage` 中增加 `ensurePrivacyAuthorized()` 预检。 + +4. **统一接口调用** - 登录/注册页统一使用 `request.post` + `SERVER_API_URL` 调用 `/wx-login/loginByMpWxPhone`。 - 修复 `register.tsx` 原本错误使用 `https://shop-api.websoft.top` 的问题。 -4. **顺手修复构建错误** +5. **顺手修复构建错误** - `src/passport/pay/index.tsx` 引用了不存在的 `@/api/passport/wx-login`，改为使用 `@/api/layout` 中的 `getWxOpenId` / `loginByOpenId`。 ## 验证 @@ -28,3 +33,9 @@ ## 测试前清理 由于之前 `Taro.showModal` 的授权无效，微信可能已缓存该状态。重新上传后请先在开发者工具或真机中清理小程序缓存，再重新进入登录页，触发新的 PrivacyModal。 + +## 重要说明 + +- 微信基础库 3.16.1+ 强制要求：调用 `getPhoneNumber`、`chooseImage` 等敏感 API 前，用户必须先同意《用户隐私保护指引》。 +- 即使登录页不再主动预检，当用户点击「手机号快捷登录」且未授权时，微信仍会强制弹出隐私授权框。这是微信机制，无法绕过。 +- 如果用户已同意隐私协议但手机号登录仍失败，请重点检查后台是否已开通「手机号快速验证组件」能力，以及隐私指引中是否包含「手机号」声明。 diff --git a/src/components/PrivacyModal/index.tsx b/src/components/PrivacyModal/index.tsx index c5bccb2..8ed976b 100644 --- a/src/components/PrivacyModal/index.tsx +++ b/src/components/PrivacyModal/index.tsx @@ -30,7 +30,7 @@ const PrivacyModal = () => { 隐私协议授权 - {`为提供完整服务，需您同意 ${contractName}。点击同意后可继续使用手机号快捷登录、相册等功能。`} + {`为提供完整服务，需您同意 ${contractName}。点击同意后可继续使用相关功能。`}