小程序全流程指南
本文档将指导您完成微信小程序从账号申请、认证备案到代码部署发布的全流程操作。
一、 账号准备
1. 注册账号
- 访问 微信公众平台。
- 点击右上角 立即注册。
- 选择账号类型为 小程序。
- 按照提示填写邮箱、密码，激活邮箱。
- 选择主体类型（企业、个体工商户、个人等），填写主体信息并完成验证。
2. 微信认证
对于企业和个体工商户，建议完成 微信认证 以获取完整权限（如微信支付、获取用户手机号等）。
- 登录小程序管理后台。
- 进入 设置 -> 基本设置。
- 找到 微信认证 栏目，点击 详情 或 去认证。
- 按照指引上传公函、营业执照，并支付 300 元/年的认证费用。
3. 小程序备案（必须）
根据相关法律法规，所有小程序必须完成备案后才可发布上线。
- 登录小程序管理后台。
- 进入 设置 -> 小程序备案。
- 点击 去备案。
- 填写主办单位信息、主体负责人信息、小程序信息。
- 上传相关证件（营业执照、身份证等）。
- 提交初审 -> 平台审核 -> 管局审核（通常需要 3-20 个工作日）。
注意
未完成备案的小程序将无法进行版本发布，建议尽早启动备案流程。
二、 开发环境准备
1. 获取 AppID
- 登录小程序管理后台。
- 进入 开发管理 -> 开发设置。
- 复制 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. 导入项目
- 解压下载的
mp-weixin.zip。 - 打开微信开发者工具，点击 导入项目。
- 选择解压后的文件夹。
- 填写您的 AppID。
2. 修改接口地址
打开项目文件（通常在 common/vendor.js 或 config/app.js），修改 VUE_APP_API_URL：
javascript
// 请将链接修改为您自己的商城域名，注意保留 /api 后缀
export const VUE_APP_API_URL = 'https://您的域名/api';3. 本地调试
- 点击工具栏的 编译。
- 在模拟器中检查首页、分类、个人中心是否能正常加载数据。
- 如果数据加载失败，请检查：
- 域名是否已配置到后台。
- 开发者工具右上角 详情 -> 本地设置 -> 勾选 不校验合法域名（仅用于临时调试）。
四、 上传与发布
1. 上传代码
- 调试无误后，点击开发者工具右上角 上传。
- 填写 版本号（推荐格式：1.0.0）和 项目备注（如：初始版本上线）。
- 点击 上传 按钮。
2. 提交审核
- 登录 微信公众平台。
- 进入 管理 -> 版本管理。
- 在 开发版本 列表中找到刚才上传的版本。
- 点击 提交审核。
- 填写功能页面路径（通常首页为
pages/index/index），完善隐私协议。 - 提交等待微信审核（通常 1-3 个工作日）。
3. 发布上线
- 审核通过后，微信会发送通知。
- 进入 版本管理 -> 审核版本。
- 点击 发布。
- 发布后，用户即可在微信中搜索到您的小程序。
五、 常见问题
Q: 为什么提示“请求合法域名校验出错”？
A: 请检查后台“服务器域名”是否配置正确。开发阶段可在开发者工具中开启“不校验合法域名”选项。
Q: 支付功能无法使用？
A:
- 确保小程序已完成微信认证。
- 确保已关联微信支付商户号（在后台“微信支付”菜单中关联）。
- 检查支付目录配置是否正确。
Q: 备案需要多久？
A: 备案审核由各地管局负责，时间不确定，通常在 3 到 20 个工作日之间。建议提前准备。