自行部署微信小程序生产环境(node.js)—腾讯云服务器

一、前期准备

• 购买域名 + (云)服务器
• 购买https证书

二、解决方案

在一台(云)服务器上，安装好运行环境(nodejs+mysql+pm2+nginx)，然后通过pm2运行小程序后端项目，并在nginx中配置https访问。

三、(云)服务器环境部署(基于Ubuntu)

1. nginx安装

请参考：ubuntu 安装 nginx(亲测有用)

2. nodejs安装

请参考：手动搭建Nodejs环境 (Linux & Window)

3. pm2安装

请参考：pm2：带负载均衡功能的Node应用进程管理工具

4. mysql安装

请参考：MySQL 安装(Windows & Linux)

5. 配置HTTPS
   可参考：
   - Nginx 服务器SSL证书安装
   - Nginx 配置http和https访问

四、部署后端项目

进行到这一步，(云)服务器的环境都已经搭好了。接下来我们就来将小程序的后端项目部署到(云)服务器上。

1. 登录微信小程序公众平台

2. 获取AppID(小程序ID)，AppSecret(小程序密钥)，设置服务器域名（PS：域名需要备案后才能填写。）

图片.png

3. 下载后端项目官方模板，模板中的server目录即是后端项目
   Github仓库地址:Wafer2-startup

4. 配置server/config.js

const CONF = {
    port: '5757',
    rootPathname: ' /data/release/weapp' ,   //服务器上server文件夹地址与此处一致
 
    // 填写微信小程序 App ID
    appId: 'wx33333',       
 
    // 填写微信小程序 App Secret
    appSecret: 'wx22222',
 
    // 是否使用腾讯云代理登录小程序 
    useQcloudLogin: false,               // 可直接使用微信登陆小程序 因为使用阿里云改为false
 
    /**
     * MySQL 配置，用来存储 session 和用户信息
     * 若使用了腾讯云微信小程序解决方案
     * 开发环境下，MySQL 的初始密码为您的微信小程序 appid
     */
    mysql: {
        host: '服务器IP',//很多文档都写的云数据库内网IP,关于这一点我写的服务器公网IP一样可以用，不太了解
        port: 3306,
        user: 'root',
        db: 'cAuth',
        pass: '服务器数据库密码',//之前操作修改过
        char: 'utf8mb4'
    },
 
    cos: {//这个地区没什么影响，可以不改
        /**
         * 区域
         * 华北：cn-north
         * 华东：cn-east
         * 华南：cn-south
         * 西南：cn-southwest
         * 新加坡：sg
         * @see https://cloud.tencent.com/document/product/436/6224
         */
        region: 'cn-south',
        // Bucket 名称
        fileBucket: 'qcloudtest',
        // 文件夹
        uploadFolder: ''
    },
 
    // 微信登录态有效期
    wxLoginExpires: 7200,
 
    // 其他配置 ...

    serverHost: '你的域名',
    //以下配置可以留空不填 但是参数一定要有 否则会报错
    tunnelServerUrl: '',//腾讯云信道服务地址 很多文档里写的地址打开直接404
    tunnelSignatureKey: '',
    // 可以注册一个腾讯云账号，获取一下配置。腾讯云相关配置可以查看云 API 秘钥控制台： 
    // https://console.cloud.tencent.com/capi
    qcloudAppId: '你的腾讯云 AppID',
    qcloudSecretId: '你的腾讯云 SecretId',
    qcloudSecretKey: '你的腾讯云 SecretKey',
    wxMessageToken: 'weixinmsgtoken',
    networkTimeout: 30000
}
 
module.exports = CONF

4. 将client/config.js复制到小程序前端项目src目录下，并修改配置。
   此config.js的作用：主要配置host(后端项目的域名/ip地址端口)，便于请求后端接口，访问后端资源。

   
   
   图片.png

5. 将后端项目上传至(云)服务器
   ！！！再次注意：后端项目在(云)服务器上的路径需与server/config.js中的配置项rootPathname保持一致

6. 安装项目依赖

# 进入项目根目录下
npm install

7. 初始化数据库
   可使用后端项目tools/initdb.js工具来初始化数据库

node tools/initdb.js

若数据库初始化成功后，可以查看数据表，如下图：

图片.png

初始化数据库可能遇到的问题：
1.提示远程数据库连接失败:
Error: ER_HOST_NOT_PRIVILEGED: Host 'iZwz93gye2rcpm8b1ra8zwZ' is not allowed to connect to this MySQL server

问题原因：可能是数据库的安全预防措施。
解决方法：登录数据库，尝试添加新的拥有所有操作权限的数据库管理员帐号。

mysql> CREATE USER 'username'@'%' IDENTIFIED BY 'some_pass';
mysql> GRANT ALL PRIVILEGES ON *.* TO 'username'@'%' WITH GRANT >OPTION;

成功添加新的数据库账号后,别忘了修改server/config.js里的数据库登录账号和密码。

8. nginx配置后端项目

server {
    listen      443;
    
    # ...省略https配置

    location / {
        proxy_pass http://127.0.0.1:5757/;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

8. 启动后端项目(推荐：使用pm2启动并监控)

node app.js

9. 检查是否可以正常访问
   直接访问 https://你的域名/weapp/login，会提示：{"code":-1,"error":"ERR_HEADER_MISSED"}，则表示配置成功。

PS:注意这一步访问的地址一定是域名后接/weapp/login而不是官方文档里写的http://你的域名/login，访问后面这个地址会得到：{"code":0,"data":{}}。
原因：因为weapp是后端项目中配置的路由前缀。

图片.png

图片.png