结论先行:wechat-app-mall 是 api工厂 社区维护多年的开源微信小程序商城,商品、订单、支付、营销接口全部由 api工厂 提供。上手只需四步:克隆代码、在 app.js 里初始化你的 subDomain、在后台配置小程序 appid 与支付、用微信开发者工具上传发布。本文按目录结构、关键配置、发布流程拆解一遍,并附上常见踩坑清单。
一、项目与仓库地址
wechat-app-mall 是一套功能完整的微信小程序商城前端,包含首页、分类、商品详情、购物车、下单支付、订单售后、个人中心、积分签到等页面,后端零代码,全部走 api工厂 开放接口。
项目依赖官方 SDK apifm-wxapi,接口返回统一为 {code, data, msg},code == 0 即成功。更多同类项目见开源项目大全。
二、前置准备
- 注册并登录管理后台 https://admin.it120.cc/ ,记下你的专属域名 subDomain;
- 在微信公众平台注册小程序账号,拿到 appid 与 secret;
- 安装微信开发者工具与 Node.js;
- 克隆代码后在项目目录执行 npm install,并在开发者工具里执行「构建 npm」,否则会出现找不到 apifm-wxapi 包的报错。
三、目录结构速览
| 目录/文件 | 作用 |
|---|---|
| app.js | 全局入口,SDK 初始化在这里 |
| pages/ | 各业务页面:商品、购物车、订单、我的等 |
| utils/ | 工具函数与请求封装 |
| miniprogram_npm/ | 构建 npm 后的 SDK 产物 |
| app.json | 页面路由、tabBar、窗口样式 |
| project.config.json | 项目 appid 与编译配置 |
改界面基本只动 pages 与 app.json;改业务逻辑前先读 utils 里的封装,避免重复造轮子。
四、三处关键配置
第一处:SDK 初始化。在 app.js 中找到初始化代码,换成你的专属域名:
const WXAPI = require('apifm-wxapi')
WXAPI.init('你的subDomain')第二处:后台绑定小程序。在 api工厂 后台「微信(小程序)开发」里填入 appid 与 secret,平台才能替你完成登录态换取、生成小程序码、发送订阅消息等动作。
第三处:合法域名。在微信公众平台「开发设置—服务器域名」中,把 api工厂 的接口域名与文件域名加入 request、uploadFile、downloadFile 合法域名列表。开发阶段可勾选「不校验合法域名」,但提审前必须配置完整,否则线上全部请求都会被拦截。详细步骤可参考帮助中心的设置合法服务器域名教程。
五、本地调试与真机预览
开发者工具里重点看两个面板:Network 面板确认每个请求的 code 是否为 0,Console 面板看业务报错。遇到接口行为不确定,先到在线 Playground 单独调一遍,确认参数与返回后再回项目里排查,效率远高于反复改代码重试。真机预览时注意:体验版同样受合法域名约束,白屏或请求失败优先检查域名配置与 subDomain 是否一致。提审前建议准备一批演示数据:三到五个真实商品、完整的分类与轮播图、可正常支付的测试价格,审核人员会实际点开页面操作,空壳商城或满屏「测试商品」容易被驳回。订单售后、快递查询、收货地址这些页面也要逐一过一遍,确保没有死按钮。
六、支付与营销配置
微信支付需要在后台完成商户号关联与支付参数配置,并确认小程序 appid 与商户号的绑定关系,否则会报「appid 和 mch_id 不匹配」。营销能力如优惠券、拼团、砍价、三级分销均为平台内置模块,后台开启后前端接对应接口即可,不需要自己写服务端逻辑。免费会员 10 QPS 仅供开发调试,正式运营建议专业版 399 元/年起步,详见价格页,会员不支持退款,请先确认需求。
七、发布流程
- 开发者工具点击「上传」,填写版本号与备注;
- 在微信公众平台设为体验版,拉团队成员完整走一遍下单支付;
- 提交审核:类目要与实际经营内容一致,涉及食品、医疗等需上传对应资质;
- 审核通过后全量发布,发布后立刻用线上版本回归一次支付链路;
- 后续迭代保持「体验版验证—提审—发布」的节奏,善用灰度发布降低风险。
八、常见踩坑速查
| 报错/现象 | 原因 | 处理 |
|---|---|---|
| 没有找到可以构建的 NPM 包 | 未执行 npm install | 先安装依赖再构建 npm |
| apifm-wxapi is not defined | 未构建 npm 或引用路径错 | 重新构建并核对 require 路径 |
| 无法获取 openid | 后台未配 appid/secret | 补齐小程序配置 |
| 请求全部失败 | 合法域名未配置 | 公众平台补齐服务器域名 |
| 支付报 appid 不匹配 | 商户号绑定关系缺失 | 按官方教程完成 MA 授权 |
文章标签
相关产品
api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。