首页  思维导图  详情



 



微信小程序开发流程实操指南（最新版）

2026-09-23 14:21:48   0  举报





微信小程序最新实操指南专治各种“卡脖子”。从最搞心态的ICP备案，到微信登录、支付v3接口对接，再到防伪造回调验签，全给你盘明白。没废话，全是保姆级步骤和血泪避坑经验。不管你是全栈新手还是外包团队，照着走，少走半个月弯路，一次过审上线！

微信小程序开发

小程序备案

微信支付对接

小程序登录

小程序对接流程

模板推荐

作者其他创作

大纲/内容

📝 一、申请与资质准备（务必先做备案）

🔑 1.1 注册小程序账号

步骤1：访问微信公众平台（mp.weixin.qq.com）

步骤2：点击"立即注册"，选择"小程序"

步骤3：填写未注册过公众平台的邮箱

步骤4：登录邮箱，点击激活链接

步骤5：选择主体类型

个人：功能受限，不能开通支付

企业：功能完整，可开通支付（需营业执照）

步骤6：完成主体认证

个人：身份证 + 微信扫码验证

企业：营业执照 + 对公打款验证（或微信认证）

⚠️ 一个邮箱只能注册一个小程序

📋 1.2 完善基础信息（审核前提）

路径：小程序后台 → 设置 → 基本设置

小程序名称：全局唯一，先占先得

小程序头像：品牌 logo

服务类目：必须与实际功能匹配，选错会被拒审

🛡️ 1.3 小程序备案（2024 年起强制）★

政策：未备案无法提交审核、无法上架

路径：小程序后台 → 设置 → 基本设置 → 小程序备案

步骤

步骤1：发起备案，填写主体信息

步骤2：填写负责人信息

步骤3：上传证件（营业执照、身份证）+ 人脸核验

步骤4：提交微信初审（1-2 个工作日）

步骤5：初审通过后提交管局审核（1-20 个工作日）

步骤6：管局通过，获得备案号（需展示在小程序内）

⚠️ 注册完立刻提交备案，与开发并行，避免开发完干等

🆔 1.4 获取开发凭证

路径：开发 → 开发管理 → 开发设置

AppID：小程序唯一标识（前端+后端用）

AppSecret：密钥（仅后端，登录用）

⚠️ AppSecret 只显示一次，绝不写进前端代码

💰 1.5 开通微信支付（需要才做）

前提：企业主体

步骤1：注册微信支付商户号（pay.weixin.qq.com）

步骤2：在小程序后台绑定商户号

步骤3：配置 API v3 凭证

申请商户 API 证书（下载证书序列号 + 私钥文件）

设置 APIv3 密钥（32位字符串）

⚠️ 新项目用 v3，不要用 v2

💻 二、开发环境

🛠️ 2.1 环境搭建与项目创建

步骤1：下载并安装"微信开发者工具"（官方）

步骤2：微信扫码登录

步骤3：新建项目，填入 AppID（测试可用测试号）

步骤4：创建完成，模拟器可见默认页面

步骤5：点击"预览"，扫码真机体验

📂 2.2 项目结构（了解即可）

全局文件

app.js：入口逻辑、全局数据（globalData）

app.json：全局配置（页面路由 pages、底部导航 tabBar）

app.wxss：全局样式

页面文件（每个页面一个文件夹）

.wxml（结构）、.wxss（样式）、.js（逻辑）、.json（配置）

关键：新增页面必须在 app.json 的 pages 中注册

🌐 2.3 网络请求封装（对接后端必需）

基础：wx.request 发起请求

建议封装统一的 request 函数

统一加 baseURL 和 token（放 header）

统一处理错误（如 401 重新登录）

返回 Promise，方便 async/await

请求要求：必须是配置的合法域名 + HTTPS

🔗 三、核心能力对接（攻坚阶段，重点）★

🌐 3.1 配置服务器域名（对接前提）

路径：开发 → 开发管理 → 开发设置 → 服务器域名

配置 request 合法域名（接口请求）等

要求：HTTPS + 已备案，不能用 IP/localhost

开发阶段可勾选"不校验合法域名"调试，上线前必须配置正式域名

🔐 3.2 微信登录对接（必须掌握）★

核心概念

code：前端 wx.login 获取的临时凭证（一次性，约5分钟有效）

openid：用户在当前小程序的唯一标识

session_key：会话密钥（仅后端，用于解密敏感数据）

token：你自己生成的登录态

完整流程（8步）

步骤1：前端调用 wx.login()，获取临时 code

步骤2：前端把 code 发给后端登录接口

步骤3：后端调用微信 code2session 接口

地址：<a href="https://api.weixin.qq.com/sns/jscode2session">https://api.weixin.qq.com/sns/jscode2session</a>

参数：appid、secret、code

步骤4：微信返回 openid 和 session_key 给后端

步骤5：后端生成自定义 token，与 openid 关联（存库/缓存）

步骤6：后端把 token 返回给前端

步骤7：前端存储 token（wx.setStorage）

步骤8：后续请求在 header 携带 token，后端校验

⚠️ 关键点

code 一次性、会过期

AppSecret、session_key 只在后端，不能给前端

token 是你自己设计的，微信不管

👤 获取用户头像昵称（2024 最新规范）

旧接口 wx.getUserProfile 已废弃（不再返回真实头像昵称）

新方式：头像昵称填写能力

头像：button 组件 open-type="chooseAvatar"

昵称：input 组件 type="nickname"

用户主动选择填写，非静默获取

📱 获取手机号（可选）

前提：企业主体 + 开通权限

流程

前端放 button，open-type="getPhoneNumber"

用户授权后返回加密数据（encryptedData、iv）

前端发给后端，后端用 session_key 解密

⚠️ 解密必须在后端

💰 3.3 微信支付对接（必须掌握）★

核心概念

prepay_id：预支付交易会话标识（后端调统一下单获得）

商户 API 证书：用于请求签名（v3）

APIv3 密钥：用于回调解密验签

完整流程（8步）

步骤1：前端提交订单，调后端"创建订单"接口

步骤2：后端创建订单，调微信"统一下单"接口，获取 prepay_id

接口：POST /v3/pay/transactions/jsapi（v3）

步骤3：后端生成支付参数并用商户证书私钥 v3 签名

⚠️ 金额单位是【分】（1元=100）

步骤4：后端把支付参数返回给前端

步骤5：前端调 wx.requestPayment，传入参数，调起支付

步骤6：用户完成支付

⚠️ 前端回调不可靠，不能作为支付成功依据

步骤7：微信异步回调后端通知接口

后端用 APIv3 密钥验签、解密

验签通过后更新订单状态

⚠️ 必须做幂等处理（微信可能重复通知）

步骤8：前端确认支付结果（轮询后端订单状态，最可靠）

⚠️ 支付安全要点

后端必须验签，防伪造回调

金额校验：回调金额与订单一致

幂等处理：防重复处理

商户证书、APIv3密钥只在后端

🛠️ 开发建议

使用官方 SDK，避免手动签名

Java：wechatpay-java

Node.js：wechatpay-node-v3

PHP：wechatpay-php

🧪 四、测试与验证

🖥️ 4.1 工具调试

模拟器看效果，调试器看日志/网络请求

关闭"不校验合法域名"，测试真实域名

📱 4.2 真机测试

点击"预览"扫码体验

重点：登录闭环、支付闭环、核心业务、多机型兼容

👥 4.3 体验版测试

上传代码后设为体验版，添加体验成员测试

✅ 4.4 测试检查清单

核心功能正常

域名配置正确

无明显 bug

📤 五、审核与发布

🚀 5.1 上线完整流程

步骤1：开发者工具点击"上传"，填版本号

步骤2：后台设为体验版

步骤3：体验版测试通过

步骤4：提交审核（版本管理 → 提交审核）

⚠️ 确保已完成 ICP 备案，否则无法提审

步骤5：等待审核（一般 1-3 天）

步骤6：审核通过后发布（全量或分阶段灰度）

步骤7：发布后观察线上运行

⚠️ 5.2 审核避坑

类目正确：功能与类目匹配

内容合规：无诱导分享、虚假宣传

资质齐全：特殊行业需资质

功能完整：无明显 bug

备案号需展示在小程序内

🔥 5.3 加急审核

官方每年提供有限次数加急（几小时出结果）

适用：紧急修复线上 bug

🔄 六、更新与迭代

🚀 6.1 版本更新

流程与首次上线一致：改代码 → 上传 → 提审 → 发布

⚠️ 每次更新都要重新审核

🔙 6.2 回滚

线上出问题，回退到之前线上版本

路径：版本管理 → 线上版本 → 版本回滚

回滚是紧急止损第一手段

📊 6.3 灰度发布

发布时选"分阶段发布"

先发部分用户，观察无问题再全量

🚨 6.4 线上紧急处理

第一步：回滚到稳定版本（止损）

第二步：定位修复问题

第三步：重新走审核发布

⚡ 七、速查清单

🔑 关键凭证

AppID：前端+后端

AppSecret：仅后端（登录）

商户号：仅后端（支付）

商户 API 证书：仅后端（支付 v3 签名）

APIv3 密钥：仅后端（支付回调解密）

🔗 核心接口/方法

支付：统一下单（后端）、支付回调（后端）、wx.requestPayment（前端）

请求：wx.request（前端）

头像昵称：open-type="chooseAvatar" + type="nickname"

手机号：open-type="getPhoneNumber"

📋 关键流程速记

支付：后端统一下单拿prepay_id → v3签名 → 前端wx.requestPayment → 微信回调后端 → 验签更新订单 → 前端轮询确认

上线：上传代码 → 体验版 → 提交审核 → 审核通过 → 发布

⚠️ 高频坑

域名必须 HTTPS + 已备案 + 已配置

2024 年起未备案无法上架，尽早提交

AppSecret/商户证书/APIv3密钥绝不放前端

支付金额单位是【分】

支付结果以后端回调为准

code 一次性、会过期

头像昵称用新组件，旧接口已废弃

支付用 v3，不要用 v2

每次更新都要重新审核

 Collect

Get Started

微信小程序初步了解

 Collect

Get Started

小红书运营实操指南

 Collect

Get Started

2026年最新版视频号知识地图

 Collect

Get Started

微信小程序直播方法培训





0 条评论

下一页