跳到主要内容
api工厂
开源项目

wechat-app-mall 小程序商城上手:目录结构、关键配置与发布流程

api工厂资讯栏目 约 5 分钟阅读
本文由 AI 辅助生成,内容基于公开资讯整理改写,技术细节以官方文档为准。

结论先行:wechat-app-mall 是 api工厂 社区维护多年的开源微信小程序商城,商品、订单、支付、营销接口全部由 api工厂 提供。上手只需四步:克隆代码、在 app.js 里初始化你的 subDomain、在后台配置小程序 appid 与支付、用微信开发者工具上传发布。本文按目录结构、关键配置、发布流程拆解一遍,并附上常见踩坑清单。

一、项目与仓库地址

wechat-app-mall 是一套功能完整的微信小程序商城前端,包含首页、分类、商品详情、购物车、下单支付、订单售后、个人中心、积分签到等页面,后端零代码,全部走 api工厂 开放接口。

项目依赖官方 SDK apifm-wxapi,接口返回统一为 {code, data, msg},code == 0 即成功。更多同类项目见开源项目大全。

二、前置准备

  1. 注册并登录管理后台 https://admin.it120.cc/ ,记下你的专属域名 subDomain;
  2. 在微信公众平台注册小程序账号,拿到 appid 与 secret;
  3. 安装微信开发者工具与 Node.js;
  4. 克隆代码后在项目目录执行 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 中找到初始化代码,换成你的专属域名:

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 元/年起步,详见价格页,会员不支持退款,请先确认需求。

七、发布流程

  1. 开发者工具点击「上传」,填写版本号与备注;
  2. 在微信公众平台设为体验版,拉团队成员完整走一遍下单支付;
  3. 提交审核:类目要与实际经营内容一致,涉及食品、医疗等需上传对应资质;
  4. 审核通过后全量发布,发布后立刻用线上版本回归一次支付链路;
  5. 后续迭代保持「体验版验证—提审—发布」的节奏,善用灰度发布降低风险。

八、常见踩坑速查

报错/现象原因处理
没有找到可以构建的 NPM 包未执行 npm install先安装依赖再构建 npm
apifm-wxapi is not defined未构建 npm 或引用路径错重新构建并核对 require 路径
无法获取 openid后台未配 appid/secret补齐小程序配置
请求全部失败合法域名未配置公众平台补齐服务器域名
支付报 appid 不匹配商户号绑定关系缺失按官方教程完成 MA 授权

文章标签

wechat-app-mall小程序商城开源项目发布流程

相关产品

api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。