欢迎光临
我们一直在努力

一个人,9 个大版本,11 个云函数:我的汽车涉水风险小程序开发全记录

一、为什么做这个

每年汛期,开车的人都在赌两件事:

  • 前面那段积水,到底多深?
  • 我这台车,到底能不能过?
  • 导航不管这件事。天气 App 只告诉你"有暴雨",不告诉你"你下班那条路会不会淹"。网上查"XX 车涉水深度",答案散落在十个论坛帖里,还互相打架。

    所以我做了这个小程序——「汽车涉水风险等级」,个人开发者作品,纯微信生态,微信搜索名字即可进入。

    先说结论,免得你往下翻:

    • 29 个页面、5 个 Tab、11 个云函数,主包 1.7MB(红线 2MB)
    • 从 v1.x 迭代到 v9.0,核心能力是"输入车型 + 路线 → 输出分段涉水风险等级"
    • v9.0 接入了微信虚拟支付,个人主体,¥1 单次解锁深度路线分析
    • 全程无融资、无团队、无后端服务器(云开发 Serverless)

    更重要的是:个人主体做虚拟支付,网上几乎没有任何一份完整的踩坑实录。我把 9.0 联调全过程记录在第四、五节,每一条都是真金白银(以及差一点白花的真金白银)换来的。

    二、它现在长什么样(v9.0 全貌)

    五个 Tab:用车 / 坐飞机 / 差旅 / 财经 / 我的。

    用车(核心):

  • 车辆涉水风险查询:输入车型,给出可安全通过的积水深度与风险等级
  • 出行规划:起终点输路线,沿路分段着色,高风险路段标红
  • 积水地图 + 涉水车百科(30+ 热门车型涉水参数横评)
  • 实时天气 + 分钟级降水 + 暴雨订阅消息提醒
  • 停车标记、证照到期提醒、进京证提醒、保养/胎压/应急清单
  • 坐飞机:43 家航司官方小程序一键直达 + 常旅客卡管理。

    差旅:特产与推荐门店、出差天气、行前清单、客户拜访路径规划(算好你几点出门、几点打车)。

    财经:108 家公司财报披露预告订阅、各大行定期存款利率对比、DeepSeek 更新资讯订阅。

    v8 好公司榜:212 家公司"打工人友好指数"公开口碑整理(个人主体不能做 UGC,全部人工整理 PGC + 显著标注"仅供参考")。

    v9 会员中心:微信虚拟支付,¥1 解锁单次深度路线分析 / 月卡 / 年卡。

    三、版本演进:一个小程序怎么长出 9 个大版本

    版本

    主题

    一句话

    v1.x

    涉水查询核心

    输入车型和积水深度,告诉你能不能过

    v2.0

    航司导航中心

    顺手解决"43 家航司小程序找不到"

    v3.0

    智能避险出行

    出行规划 + 积水地图 + 涉水车百科,从"查一辆车"到"算一条路"

    v3.0.1-3.0.3

    订阅消息 + 海报 + 停车

    暴雨主动推送、分享海报、停车找车

    v4.0-4.2

    差旅 Tab

    出差四件套 + 进京证提醒

    v4.3-4.5

    财经 Tab

    财报披露订阅、DeepSeek 资讯订阅

    v5.0

    出行风险中心

    功能聚合

    v6.0

    个人物品管理

    数码产品二手估值、到期提醒、冗余盘点

    v7.0

    季节性风险引擎

    四季风险 PGC + 养车日历 + 年度养车报告分享卡

    v8.0

    好公司榜

    212 家公司打工人友好指数

    v9.0

    会员 + 虚拟支付

    个人主体收款闭环

    演进逻辑其实就一条:围绕"出行"这个场景,把高频痛点一个个兜住,再让功能之间互相导流。查车型的用户会用到出行规划,出行规划的用户会需要暴雨提醒,来查暴雨的人顺手看看存款利率——每个功能都是下一个功能的入口。

    个人开发者没有运营预算,产品内的交叉导流就是全部的增长引擎。

    四、核心技术:路线涉水风险是怎么算的

    这是全文最"硬"的一节,做地理/天气/风控相关的可以直接参考。

    输入:起点、终点、车型(含最大涉水深度 maxWade) 输出:分段着色的路线图 + 每段风险等级 + 整体结论

    几个关键设计决策:

  • 降雨修正用文本分级。高德免费档天气 API 没有逐小时降水,就用天气描述文本(暴雨/大雨/中雨/小雨/无雨)映射修正系数。免费额度内够用,精度损失可控。
  • 采样分批并发。一次分析最多 15 个采样点 × 每点 2-3 次 API 调用,串行会超时,全并发会触发限流。每批 3 个点并发,是实测出来的平衡点。
  • Overpass 降级。水系查询失败时不阻断流程,退化为"海拔+坡度+地表"三维评分。任何外部依赖都必须假设它会挂。
  • 云端缓存。同一条路线 30 分钟内复用缓存(route_risk_cache 集合),API 配额是个人开发者的命根子。
  • 必须强调的边界:这是风险等级参考,不是精确预测。所有页面都有显著标注。做工具类产品的同好,这条红线请焊死——既是合规,也是良心。

    五、个人主体的紧箍咒(合规设计)

    个人主体小程序,平台限制比企业主体多一倍,每一条都直接影响架构:

  • 不能做 UGC。所以积水地图的用户上报是"本地记录 + 公开数据叠加",不是社区;好公司榜全部人工整理,页面显著标注"公开口碑整理·仅供参考"。
  • 禁用 web-view。43 家航司、财报官网,全部走"复制链接去浏览器打开"。
  • 不能收集用户身份信息。全产品无手机号、无注册、无昵称,数据全本地存储,云端只有 openid 关联的订阅记录。
  • 订阅消息一次性。1 次授权 = 1 次推送,推完即消耗。这决定了推送体系必须"克制"——只在暴雨预警、证照临期、财报披露这种确定性场景请求授权。
  • 包体积 2MB 红线。29 个页面塞进 1.7MB,靠的是 PGC 静态库模式:特产库、航司库、公司池、存款利率全部内置 JS 常量,不爬后端、不存数据库。
  • 限制不是敌人。每一条限制都在逼你做减法,而做减法恰恰是个人开发者最需要的能力。

    六、v9.0 虚拟支付踩坑实录(重点)

    2026 年个人主体开放微信虚拟支付后,我决定把"深度路线分析"做成 ¥1 单次付费。以下是联调全过程踩过的坑,按时间顺序,每个都是现象 → 根因 → 解法。

    坑 1:云函数只打包本函数目录

    现象:云端报 Cannot find module '../_shared/virtualpay-config',statusCode 443。

    根因:我按常规工程习惯建了 cloudfunctions/_shared/ 放公共配置,但微信云函数部署只打包函数目录本身,父目录、兄弟目录一概不带。

    解法:把 virtualpay-config.js 和 goods.js 复制进每个云函数目录,require('./virtualpay-config')。重复但可靠。云函数项目不要指望任何形式的"共享目录"。

    坑 2:cloud.openapi 云调用权限

    现象:cloud.openapi.auth.code2Session 报 invalid wx openapi access_token。

    根因:openapi 系列调用需要云调用权限,而控制台的权限入口在不同版本界面里位置不同,文档和实际界面对不上。

    解法:干脆绕开 openapi,直接 HTTPS 调 https://api.weixin.qq.com/sns/jscode2session,AppSecret 走云函数环境变量。当一条官方路径反复报权限错误时,用 HTTP API 平替往往是更快的选择。

    坑 3:道具创建冷静期

    现象:requestVirtualPayment:fail COIN_OR_PRODUCT_ID_CREATED_IN_RECENTLY。

    根因:道具刚创建/刚改价,微信有几分钟到几十分钟的反作弊锁定期。改一次价格,冷静期重新计时。

    解法:没有解法,等。第一次创建和每次改价后,预留 30 分钟再测。

    坑 4:GOODS_PRICE_INVALID

    现象:支付拉起失败,报价格无效。

    根因:代码里 goodsPrice 的单位是分,MP 后台道具价格是元。¥1 的道具,代码传 100,后台填 1,单位对不上就报错。

    解法:代码 priceCent 与后台价格必须严格一致。三件套建议:后台创建道具 → 核对分/元 → 代码 priceCent 逐字段对齐。

    坑 5:iOS 模拟器撞 Apple IAP

    现象:iOS 端拉起支付,弹的是 Apple IAP 相关失败。

    根因:iOS 虚拟支付需配置苹果 IAP 共享密钥(Apple Developer 账号 ¥688/年起步),我没配。

    解法:Android 真机完成全部验证。iOS 侧要么后续配 IAP,要么暂时对 iOS 用户隐藏付费入口。个人主体先别碰 IAP,投入产出不成立。

    坑 6:付了钱,权益不到账(最凶险的一个)

    现象:Android 真机真付 ¥1 成功,微信扣款完成,会员中心权益卡——空的。

    根因:架构缺陷。原实现里,权益只在"支付成功回调后的 60 秒轮询窗口"内写入本地缓存;云端 entitlements 集合只有 payNotify 推送才写,而前端从不读云端。用户切走 App、回调丢失、推送未达——任何一个环节出问题,钱就白付了。代码里甚至有一个写好的 syncFromCloud() 函数,但全项目没有一处调用它。

    解法:三处重构——

  • payQuery 云函数增加 sync 模式:返回该用户云端权益列表,并自动补发"已支付但未发货"的订单(查 pay_orders 里 status=pending 的单,调微信 query_order 确认后补写权益)
  • 前端在会员中心 onShow / App onShow / 支付成功回调三个时机主动拉云端同步,云端成为权威数据源
  • 同步失败绝不覆盖本地(防御式:配置缺失时返回 configWarn,前端跳过覆盖)
  • 上线后,那笔已付未发货的订单在下一次打开会员中心时自动补发到账。

    这一坑的教训值所有前五坑之和:支付成功 ≠ 权益到账。任何付费系统,都必须有"云端对账 + 自动补发"这条兜底链路。

    坑 7:版本号三处同步

    现象:上传新版后,"我的"页仍显示旧版本号。

    根因:版本号散落在 utils/changelog.js、pages/mine/mine.js 的 version 字段、以及其他硬编码页面,改了一处漏两处。

    解法:发版 checklist 固化三处同步,发版前 grep 扫一遍所有硬编码版本号。

    坑 8:WXML 表达式限制

    现象:某个页面整文件静默不生效,无任何报错。

    根因:WXML 模板表达式禁用方法链式调用(.toFixed()/.split())、变量方括号访问 obj[k]、嵌套三元 + 字符串拼接,甚至表达式内的非 ASCII 字面量(比如中文)都会触发整文件不打包。

    解法:所有格式化在 JS 算好,WXML 只做 {{var}} 渲染。这条铁律救了我无数次。

    七、变现设计:¥1 的定价逻辑

    v9.0 的付费设计遵循三个原则:

  • 付费点选在"重度能力"上。免费版完整保留查询、对比、天气、提醒等高频功能;付费解锁的是"深度路线分析"(更多采样点 + 实时水系 + 海拔热力)。高频免费引流,重度付费变现,不阉割基础体验。
  • ¥1 定价。单次解锁定价 ¥1 是刻意的:决策成本趋近于零,第一次付费的破冰价值远大于收入本身。月卡/年卡服务高频用户。
  • 广告与付费双轨。非会员看流量主广告(banner/插屏/激励视频),会员免广告。插屏做了 5 分钟会话节流——过审风险和体验疲劳都要防。
  • 个人开发者的变现没有秘密:广告是基本盘,付费是天花板,两者不冲突。

    八、写给同样想做的你

  • 从一个足够尖的痛点开始。"暴雨天敢不敢过积水"比"做一个出行助手"好一百倍。先尖,再宽。
  • Serverless 是个人开发者的唯一正确答案。11 个云函数、零服务器、零运维,月成本约等于一顿早饭。
  • 合规不是负担,是护城河。个人主体的每一条限制都筛掉了一批抄袭者——能耐心做 PGC、能忍住不做 UGC 的人,本身就少。
  • 付费系统必须有对账兜底。见坑 6。
  • 每个版本只解决一类问题。9 个大版本,每个版本的增量清单我都有文档,事后回看,"克制"是唯一做对了的事。
  • 关于作者:13 年互联网广告变现/商业化经验,前大厂 P7,现在一边搬砖一边维护这个小程序和其他 AI 工具项目。欢迎在评论区交流小程序开发、虚拟支付、个人开发者变现的话题。

    风险提示:小程序所有涉水风险等级为参考性质,不构成精确预测,涉水行车请以现场实际情况和官方预警为准。

    赞(0)
    未经允许不得转载:171主机测评 » 一个人,9 个大版本,11 个云函数:我的汽车涉水风险小程序开发全记录
    分享到: 更多 (0)

    评论 抢沙发

    • 昵称 (必填)
    • 邮箱 (必填)
    • 网址