Skip to content

小程序全流程指南 ​

本文档将指导您完成微信小程序从账号申请、认证备案到代码部署发布的全流程操作。

一、 账号准备 ​

1. 注册账号 ​

  1. 访问 微信公众平台。
  2. 点击右上角 立即注册。
  3. 选择账号类型为 小程序。
  4. 按照提示填写邮箱、密码,激活邮箱。
  5. 选择主体类型(企业、个体工商户、个人等),填写主体信息并完成验证。

2. 微信认证 ​

对于企业和个体工商户,建议完成 微信认证 以获取完整权限(如微信支付、获取用户手机号等)。

  1. 登录小程序管理后台。
  2. 进入 设置 -> 基本设置。
  3. 找到 微信认证 栏目,点击 详情 或 去认证。
  4. 按照指引上传公函、营业执照,并支付 300 元/年的认证费用。

3. 小程序备案(必须) ​

根据相关法律法规,所有小程序必须完成备案后才可发布上线。

  1. 登录小程序管理后台。
  2. 进入 设置 -> 小程序备案。
  3. 点击 去备案。
  4. 填写主办单位信息、主体负责人信息、小程序信息。
  5. 上传相关证件(营业执照、身份证等)。
  6. 提交初审 -> 平台审核 -> 管局审核(通常需要 3-20 个工作日)。

注意

未完成备案的小程序将无法进行版本发布,建议尽早启动备案流程。

二、 开发环境准备 ​

1. 获取 AppID ​

  1. 登录小程序管理后台。
  2. 进入 开发管理 -> 开发设置。
  3. 复制 AppID (小程序ID),后续导入代码时需要使用。

2. 配置服务器域名 ​

进入 开发管理 -> 开发设置 -> 服务器域名,配置以下域名(需替换为您实际的商城域名):

  • request合法域名:https://您的域名
  • uploadFile合法域名:https://您的域名
  • downloadFile合法域名:https://您的域名
  • socket合法域名:wss://您的域名(如果使用了WebSocket)

提示

  • 域名必须通过 ICP 备案。
  • 必须部署 SSL 证书(支持 HTTPS)。

3. 下载工具与代码 ​

资源下载

小程序代码 (.zip): 点击下载

下载地址:https://ivett.oss-cn-beijing.aliyuncs.com/release/miseb-mer-java/mp-weixin.zip

三、 代码部署与配置 ​

1. 导入项目 ​

  1. 解压下载的 mp-weixin.zip。
  2. 打开微信开发者工具,点击 导入项目。
  3. 选择解压后的文件夹。
  4. 填写您的 AppID。

2. 修改接口地址 ​

打开项目文件(通常在 common/vendor.js 或 config/app.js),修改 VUE_APP_API_URL:

javascript
// 请将链接修改为您自己的商城域名,注意保留 /api 后缀
export const VUE_APP_API_URL = 'https://您的域名/api';

3. 本地调试 ​

  1. 点击工具栏的 编译。
  2. 在模拟器中检查首页、分类、个人中心是否能正常加载数据。
  3. 如果数据加载失败,请检查:
    • 域名是否已配置到后台。
    • 开发者工具右上角 详情 -> 本地设置 -> 勾选 不校验合法域名(仅用于临时调试)。

四、 上传与发布 ​

1. 上传代码 ​

  1. 调试无误后,点击开发者工具右上角 上传。
  2. 填写 版本号(推荐格式:1.0.0)和 项目备注(如:初始版本上线)。
  3. 点击 上传 按钮。

2. 提交审核 ​

  1. 登录 微信公众平台。
  2. 进入 管理 -> 版本管理。
  3. 在 开发版本 列表中找到刚才上传的版本。
  4. 点击 提交审核。
  5. 填写功能页面路径(通常首页为 pages/index/index),完善隐私协议。
  6. 提交等待微信审核(通常 1-3 个工作日)。

3. 发布上线 ​

  1. 审核通过后,微信会发送通知。
  2. 进入 版本管理 -> 审核版本。
  3. 点击 发布。
  4. 发布后,用户即可在微信中搜索到您的小程序。

五、 常见问题 ​

Q: 为什么提示“请求合法域名校验出错”? ​

A: 请检查后台“服务器域名”是否配置正确。开发阶段可在开发者工具中开启“不校验合法域名”选项。

Q: 支付功能无法使用? ​

A:

  1. 确保小程序已完成微信认证。
  2. 确保已关联微信支付商户号(在后台“微信支付”菜单中关联)。
  3. 检查支付目录配置是否正确。

Q: 备案需要多久? ​

A: 备案审核由各地管局负责,时间不确定,通常在 3 到 20 个工作日之间。建议提前准备。

成都艾唯特软件有限公司