适用场景前后端代码开发完成、阿里云 ECS 服务器、域名、宝塔面板域名可在阿里云上自行挑选购买规划接口二级域名api.[域名地址]核心硬性规则微信小程序正式环境仅允许 HTTPS、备案域名禁止 IP、禁止自定义端口、TLS1.2前置须知所购买的域名需要ICP备案如果在阿里云上购买的可直接在阿里云上进行 ICP 备案操作但由于管局审核标准较严格审核操作通常在7天左右阿里云官方免费 DV 证书通道受限采用宝塔面板 Let’s Encrypt 免费 SSL 证书方案通过宝塔负责后端服务部署、 Nginx 反向代理与 HTTPS 证书管理备案是最大时间卡点建议优先启动备案流程。整体流程大纲微信小程序账号准备阿里云域名实名认证 ICP 备案核心卡点备案通过域名 DNS 解析配置阿里云 RAM 子账号准备宝塔 DNS 自动申请证书使用阿里云宝塔面板配置反向代理 申请 SSL 证书ECS 安全组放行端口校验小程序前端代码环境切换微信公众平台后台各项配置上传代码、体验版测试、提交审核、正式发布高频踩坑总结一、微信小程序账号准备访问 微信公众平台 注册小程序个人小程序免费企业小程序300 元 / 年认证支付、高级接口必需注册完成获取小程序AppID前端项目配置使用提前选定小程序服务类目小程序审核依据选错会驳回若需要微信支付提前准备开通微信支付商户号。二、阿里云域名操作2.1 域名实名认证进入阿里云域名控制台找到所购买的域名完成实名认证。实名完成建议等待 1~3 个工作日保证阿里云、管局数据同步。⚠️ 备案主体、域名所有人、小程序运营主体三者必须保持一致。2.2 提交 ICP 备案重中之重阿里云控制台搜索【ICP 备案】→【新增网站备案】备案域名填写根据指引上传证件、完成人脸核验周期参考阿里云初审 1~3 天 通信管理局审核 7~20 天。备案期间不要解析域名对外正式提供服务未备案域名无法在微信后台添加为合法域名。2.3 备案通过后配置 DNS 解析阿里云【云解析 DNS】→ 选择域名新增解析记录记录类型A 记录主机记录api记录值你的 ECS 公网 IP 地址TTL默认 5 分钟 解析生效后api.[域名地址]指向阿里云 ECS 服务器。三、阿里云创建 RAM 子账号宝塔申请证书必备作用宝塔调用阿里云 DNS 接口自动添加 TXT 记录完成 SSL 证书 DNS 验证禁止使用主账号密钥阿里云控制台搜索【访问控制 RAM】→【身份安全】→【用户】→【创建用户】自定义用户名例如bt-ssl-dns勾选OpenAPI 访问创建成功保存 AccessKey ID / AccessKey Secret仅展示一次丢失需重新创建用户权限 →【新增授权】搜索并绑定策略AliyunDNSFullAccess仅 DNS 解析权限最小权限原则四、阿里云宝塔面板配置反向代理 SSL 证书后端服务提前部署完成本地监听127.0.0.1:8080示例端口替换为你的后端端口登录宝塔面板顶部导航选择【反向代理】不要选择 Java/Node/.Net 项目点击【添加项目】域名api.[域名地址]代理地址http://127.0.0.1:8080创建反向代理站点完成。在反向代理列表点击站点右侧【设置】→切换至【SSL】标签页SSL 证书选择Let’s Encrypt填写联系邮箱勾选域名api.[域名地址]验证方式DNS 验证支持通配符DNS 接口选择【阿里云 DNS】填入上一步 RAM 子账号的 AccessKey点击【申请证书】宝塔自动添加 DNS 解析记录完成 CA 校验、自动签发证书证书签发成功后勾选强制 HTTPS保存配置。设置宝塔内置定时任务证书到期前 30 天自动续签无需人工干预。可选核对 Nginx 最终配置面板自动生成五、ECS 服务器安全组校验阿里云 ECS 实例 →【安全组】→【入方向规则】确保放行TCP 80HTTPTCP 443HTTPS连通性测试浏览器访问https://api.[域名地址]/你的接口地址确认安全锁正常、接口正常返回数据。六、微信小程序前端代码改造找到项目全局请求基础地址baseUrl替换正式域名// 测试地址注释 // const baseUrl http://127.0.0.1:8080 // 线上正式地址 const baseUrl https://api.[域名地址]删除冗余调试代码、控制台日志本地开发者工具编译真机预览完整测试业务流程。七、微信公众平台后台配置mp.weixin.qq.com左侧菜单【开发管理】→【开发设置】7.1 配置服务器域名高频踩坑点找到【服务器域名】点击修改request 合法域名https://api.[域名地址]存在文件上传uploadFile 合法域名填写同一域名使用 WebSocketsocket 合法域名填写wss://api.[域名地址]重要规则每月仅支持修改 5 次域名刚备案成功建议等待 12~48 小时等待工信部数据同步否则提示域名未备案配置完成重启开发者工具生效。7.2 隐私政策配置审核必查项【设置】→【基本设置】→【服务内容与隐私设置】 小程序如果获取昵称、头像、手机号、位置等用户信息必须上线隐私政策文档否则审核直接驳回。7.3 其他补充配置完善小程序头像、名称、简介如需支付完成商户号关联。八、代码上传、测试、审核、发布微信开发者工具→ 右上角【上传】填写版本号、项目备注登录微信公众平台后台 →【开发管理】→【版本管理】→【开发版本】点击【设为体验版】生成二维码微信扫码真机全流程测试测试无 BUG 后点击【提交审核】填写版本更新说明带有登录功能务必提供测试账号密码根据业务选择对应服务类目特殊行业上传资质材料等待官方审核数小时24 小时审核通过后手动点击发布小程序正式对外上线。九、完整避坑清单宝塔环境域名必须完成 ICP 备案无备案无法在微信后台添加合法域名不要直接使用裸域名作为接口域名统一使用二级域名api.[域名地址]通过宝塔创建反向代理后端服务监听127.0.0.1禁止直接暴露公网端口SSL 证书选择 DNS 验证不要使用文件验证避免端口冲突备案刚通过不要立刻去微信后台添加域名等待工信部数据同步禁止使用 IP 地址、HTTP 协议、自定义端口作为小程序接口地址证书续签成功后宝塔会自动重载 Nginx无需手动操作真机调试正常、线上报错大多是服务器域名配置后开发者工具没有重启缓存导致。