小程序从开发到部署的完整流程

很多开发者把注意力放在功能实现上，等到要提交审核、配置域名、处理环境变量时才发现问题一堆。这篇文章按实际项目顺序，把小程序从开发到部署的关键环节讲清楚，重点放在那些容易在部署阶段暴露出来的工程问题上。

一、项目初始化阶段就要考虑部署

部署不是最后一步才做的事。项目初始化时，有几个决定会直接影响后续上线：

• AppID 与主体：个人主体无法使用支付、部分开放能力，也限制了一些类目。如果项目未来要商业化，一开始就用企业主体注册，避免中途迁移。
• 开发环境划分：至少准备开发版、体验版、正式版三套环境。接口域名、云开发环境 ID、埋点配置都应通过配置区分，而不是写死在代码里。
• 云开发还是自建后端：云开发省去服务器和备案流程，适合中小项目快速上线；自建后端灵活但需要处理 HTTPS 域名、备案、证书续期。这个选择在初始化时就要定下来。

二、接口域名与网络配置

小程序要求所有网络请求走 HTTPS，且域名需在后台配置为合法域名。常见做法是：

// config/env.js
const ENV = {
  dev: {
    baseUrl: 'https://dev-api.example.com',
    cloudEnv: 'dev-xxxx'
  },
  prod: {
    baseUrl: 'https://api.example.com',
    cloudEnv: 'prod-xxxx'
  }
}

export default ENV[process.env.NODE_ENV || 'dev']

部署前检查三件事：域名是否已备案、证书是否在有效期内、后台「开发管理 - 服务器域名」是否已添加。注意 request、uploadFile、downloadFile、socket 是分开配置的，漏配一个就会在真机上失败。开发阶段可以在开发者工具里勾选「不校验合法域名」，但这只是临时手段，体验版和正式版不会生效。

三、构建与代码包管理

小程序主包有 2MB 限制，总包 20MB。部署前要做的事：

• 把图片、字体等静态资源放到 CDN 或云存储，不要打进代码包。
• 使用分包加载，把非首屏页面拆到分包里。
• 开启「上传时压缩代码」，并在构建配置里去掉 sourcemap 和调试日志。
• 检查是否有未使用的依赖被打进包内，尤其是引入整个 UI 库的情况。

建议在 CI 里加一步包体积检查，超过阈值直接失败，避免每次靠人工看。

四、云开发的部署要点

如果使用云开发，部署主要涉及云函数和数据库：

// 云函数中通过环境变量区分环境
const cloud = require('wx-server-sdk')
cloud.init({ env: cloud.DYNAMIC_CURRENT_ENV })

exports.main = async (event, context) => {
  const db = cloud.database()
  // 业务逻辑
}

要点：云函数要按环境分别部署，不要用同一个环境跑测试和正式数据；数据库权限规则要在上线前收紧，默认的「所有用户可读写」是常见的数据泄露来源；定时触发器、云调用权限需要单独配置。云开发的部署命令可以通过 CI 触发，但要注意不同环境的密钥隔离。

五、提交审核与发布

上传代码后，在后台提交审核。审核前自查：

• 页面是否有空白页、报错弹窗、测试数据残留。
• 涉及用户信息的接口是否调用了授权，隐私协议是否配置。
• 类目是否与实际功能一致，功能涉及特殊行业需提供资质。
• 体验版先让内部人员完整走一遍核心流程，尤其是支付和登录。

审核通过后点击发布，注意发布是分阶段生效的，新版本不会立刻覆盖所有用户。发布后观察一段时间线上日志和错误上报，确认无异常再收尾。

六、上线后的持续维护

部署完成不等于结束。建议保留以下能力：

• 错误监控：接入小程序端错误上报，按版本和环境区分。
• 版本回滚预案：保留上一版代码包，出现严重问题时能快速回退。
• 配置热更新：把开关类配置放到服务端或云数据库，避免为改一个参数重新发版。

小程序部署的难点不在某一步操作，而在于环境、域名、包体积、权限这些细节是否在开发阶段就规划好。把这些前置工作做扎实，上线过程会顺畅很多。