Files
server/laf-cloud/repairPayUser.README.md
2026-10-12 15:40:18 +08:00

9.0 KiB
Raw Permalink Blame History

手动核验已标记付费的用户

repairPayUser 只核验 users.pay_user 为布尔值 true 的用户。查询在数据库端过滤,不扫描false、缺失或字符串标记的用户,也不修复这些用户可能存在的漏标。有效付费订单对应用户保持true;明确误标的用户改为false。

在Laf云函数控制台手动执行,无参数、无公开HTTP接口、无需定时器。单次调用自动按每页100人持续翻页,直到候选用户处理完成或达到约15秒的时间预算。返回 status=pending 时再次手动执行同一函数即可续跑;status=completed 表示本批次扫描结束,再执行会直接退出。数据量或查询耗时较大时,不保证一次调用全部完成。

本版使用独立批次 pay-user-true-only-v2-20260930,旧版 pay-user-from-orders-v1-20260930 的完成标记不会阻止这次执行。保留旧批次的任务与审计记录。

部署顺序

  1. 先发布本次修改的全部付费写入入口:wx/payCallBack、wx/iosgetPayInfo、login、goldMiner/payment、pyramid/api。这些入口在确认支付时同时写 pay_user=true 和新的 pay_user_revision。通用回调不再因旧值已经为true而跳过写入,iOS写入增加await。等待旧版本在途请求结束后再手动修复。不能只部署修复函数就认为并发支付已经受保护;维护其他付费写入入口时也必须同步更新该版本标识。
  2. 如果线上曾为 repairPayUser 创建过定时触发器,先停用或删除该触发器;本仓库已移除原定时配置文件,删除本地文件不会自动删除线上触发器。
  3. 发布 functions/repairPayUser.ts 和同名YAML,保持 methods: []。仅允许 PAYMENT_APP_ENV=production 或未设置该变量的原有正式部署;test环境拒绝执行。
  4. 在云函数控制台手动执行 repairPayUser,无需请求参数。查看返回状态和人数;pending则再次手动执行,completed则结束。发生错误时保留任务与审计记录,再次执行可续跑。
  5. 保留现有 rechargeStats 日批。修复完成的用户会被标记为VIP待核验,下一轮日批自动接续维护和清理未付费旧零统计。无需人工运行VIP重算;本函数不在一次调用中强制跑完全服VIP统计。

每次手动调用内部自动分页,无需逐页操作。超时或并发变更中断时由下一次手动调用续跑,不依赖定时器。无需向函数传预览、确认或执行参数。代码提交到仓库不等于已部署或已停用线上旧触发器。

修复规则

  • 仅按 { pay_user: true } 查询用户并按 _id分页,使用 users.openid 查询 order。有效的正式成功订单:数值型 state=1/2、非test环境、订单号不以 wct_ 开头,且订单号非空、单价和数量为正安全整数(兼容数字字符串)、总额没有溢出。
  • 使用全部历史订单,包括当天刚支付的订单,不使用VIP日批的昨日截止时间。只需一笔可信成功订单即可确认 pay_user=true;重复订单不会重复加款,因为本函数不计算或发放奖励。
  • 没有成功订单、没有待支付或不明订单,也没有迁移或历史付费证据时,直接写 pay_user=false。不先全服清零,不把所有用户临时当作未付费。
  • 有待支付订单但没有可信成功订单时跳过;某些iOS路径先写用户付费标记,再完成订单状态,因此此时不能写false。长期未支付的旧订单也会使该用户保留在异常列表,本任务不擅自关闭或删除订单。
  • 缺openid、同openid对应多个用户、无法核实的成功订单、五彩迁移/待选择/未知迁移状态,以及有旧VIP或统计付费证据却缺订单的用户均跳过并记录原因。没有订单不能证明迁移或归档前从未付费。wucai_type=-1/3按当前账号处理;有可信成功订单的迁移用户仍可修复为true。
  • 未付费修复写 users.vip_level=0 并将其画像标记为无效待核验;付费修复保留原等级,也标记无效。vip_profile.updated_at同步更新,防止较早启动的VIP任务覆盖修复状态。其他用户字段、订单、发奖与活动数据不修改。
  • 不删除 userRechargeStats,也不强行抹除历史付费证据;必要的画像重算与旧零统计清理由既有日批完成。

本任务以当前正式订单为依据。已知缺失/冲突会记录异常,但无法自动发现从未留下迁移标记或历史证据的已删除订单,发布前应确认订单库覆盖需要修复的历史范围。

并发和失败恢复

修复在读取用户身份后查询订单,写回时同时比较读取时的 pay_user_revision、付费标记、openid、注册时间、迁移状态、VIP和画像。支付回调每次产生新的随机版本标识:在修复写入前完成的回调会使比较失败;在修复写入后完成的回调会重新写true。账号或VIP期间发生变更时也不会覆盖,当前用户留到下一次调用重新读取。

固定任务记录提供60秒租约,每个用户处理前后续租,防止重复点击造成并行修复。读取/写入失败会释放锁并抛错,再次手动执行会从已保存游标继续;异常退出未释放锁时,租约过期后可接手。

每个用户先记录任务中的 pendingUserId 与修复前备份,再更新用户,最后更新审计和游标并清除pendingUserId。users.pay_user_repair保存固定批次标识和当时的修复结果;若在写用户后崩溃,下一次用该标识补齐审计与游标,不会再次把后来的新支付重置为false。改为false的用户会从普通分页查询中消失,因此恢复时先按pendingUserId读取该用户以补齐审计和计数,不重新计算其付费身份。若是外部操作将待处理用户改为false,则记录跳过;账号已删除时也继续后续用户,不重建账号。原字段是否存在以及原BSON值都会备份,不备份令牌/session key等无关敏感数据。

首次运行保存当前true用户的 _id 上界;正常分页只读取该范围内当时仍为true的用户。上界以外的账号由正常流程维护。已处理游标之前后来变为true的用户也不会回扫。分页保留原 _id 类型,沿用当前用户集合的统一ID类型约定。任务完成后不要删除任务记录/审计或随意修改批次常量,否则会失去一次性执行与恢复保护。

查看结果

任务状态保存在 payUserRepairJobs,按固定 _id 查询:

字段 含义
status pending等待再次手动执行、running执行中、completed已扫描结束
afterId / upperId 已完成游标与首次运行时true用户的上界
pendingUserId 正在处理、尚未完成审计与游标提交的用户,用于恢复已改成false的用户
processed 已处理人数,包括修复成功和跳过异常
paid / neverPaid 本批次成功确认并写为true/false的人数,不等于当前全服实时人数
skipped 保留原值的异常人数
completedAt 完成时间;存在后同批次再次手动执行不会重复修复
lastError / failedAt 最近一次执行失败记录,后续成功执行会清除lastError

completed只代表扫描结束,不代表异常用户都已修复。有异常时其他用户仍可自动完成,不等待人工确认。异常用户不会因重复点击执行而无限重置;需核查后另行修复。

payUserRepairAudit按 batch 和 status查询:

  • applied:已写回,含 userId、原因、修复前字段备份、计划值及执行时间。
  • skipped:未修改,reason说明缺身份、重复openid、待支付、订单异常、迁移历史缺失或旧付费证据冲突。
  • prepared/deferred:准备执行或因并发变更待下一次重试。

审计备份用于核对,不能全量直接回滚旧 pay_user,否则可能覆盖修复后产生的新支付。两个记录集合均使用默认 _id唯一索引;用户openid和订单openid查询应复用已有索引。建议确认users有 { pay_user: 1, _id: 1 } 复合索引,以便数据库直接定位true用户并按ID分页;没有该索引时虽然只返回true用户,数据库仍可能扫描更多文档。函数不会自动创建生产索引。

本地验证

node --test laf-cloud/tests/repair-pay-user.test.mjs laf-cloud/tests/payment-routing.test.mjs laf-cloud/tests/login-ios-reborn.test.mjs laf-cloud/tests/monthly-card-renewal.test.mjs laf-cloud/functions/goldMiner/tests/gold-miner.test.mjs laf-cloud/functions/pyramid/tests/pyramid.test.mjs

覆盖true用户核验、false/缺失/字符串标记用户不处理、单次多页扫描、v1/v2批次隔离、false用户崩溃后恢复、正式/测试订单隔离、当天订单、异常跳过、分页、一次性完成、锁竞争和超时、读取失败、写入后崩溃恢复、扫描期间支付和身份变化,以及相关支付与发奖回归。使用内存数据库替身,不连接正式服;上线需验证真实MongoDB与云函数部署环境。