fnvtk/soul
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
54204991170100c8950400457ce14cf615ff8411
soul/miniprogram/小程序部署说明.md

8.6 KiB
Raw Blame History

🚀 Soul派对小程序 - 部署完成说明

部署时间: 2025年1月14日
配置状态: ✅ 已完成配置

✅ 当前配置信息

小程序配置

项目 配置值
AppID wx0976665c3a3d5a7c
AppSecret a262f1be43422f03734f205d0bca1882
API域名 http://kr-soul.lytiao.com
API路径 http://kr-soul.lytiao.com/api

已配置文件

✅ miniprogram/project.config.json - AppID已配置
✅ miniprogram/app.js - API地址已配置
✅ .env.production - 生产环境配置
✅ app/api/wechat/login/route.ts - 微信登录接口
✅ app/api/book/latest-chapters/route.ts - 章节接口

🎯 快速测试（3步骤）

第1步：启动本地服务器

cd "/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验"

# 安装依赖（如果还没安装）
pnpm install

# 启动开发服务器
pnpm dev

✅ 看到 Ready in 2.3s 表示成功

第2步：打开微信开发者工具

  1. 打开微信开发者工具
  2. 点击 "导入项目"
  3. 选择目录： 
    /Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验/miniprogram
  4. AppID会自动识别：wx0976665c3a3d5a7c
  5. 点击 "导入"

第3步：本地联调测试

在微信开发者工具中：

  1. 点击右上角 "详情"
  2. 找到 "本地设置"
  3. 勾选 "不校验合法域名、web-view（业务域名）、TLS 版本以及 HTTPS 证书"
  4. 点击 "编译" 按钮

✅ 现在可以在模拟器中测试了！

📱 功能测试清单

首页测试

  • 书籍封面显示
  • 最新章节列表
  • 点击章节跳转
  • 购买按钮响应

匹配书友测试

  • 星空动画流畅
  • 匹配功能运行
  • 匹配成功显示

我的页面测试

  • 点击登录功能
  • 分销中心展示
  • 海报生成功能

阅读页测试

  • 章节内容加载
  • 目录侧滑
  • 书签功能

🌐 正式部署到服务器

域名配置检查

你的域名：http://kr-soul.lytiao.com

⚠️ 重要：需要配置HTTPS

小程序要求所有网络请求必须使用HTTPS！

配置SSL证书步骤：

  1. 登录阿里云控制台
  2. 进入 "SSL证书" 服务
  3. 申请免费SSL证书（DV证书）
  4. 下载证书文件
  5. 在服务器上配置证书

配置后域名应该是：

https://kr-soul.lytiao.com

服务器部署步骤

1. 将代码上传到服务器

# 方式1：使用Git
cd /var/www
git clone your-repo-url soul-party
cd soul-party

# 方式2：使用SCP上传
scp -r ./一场soul的创业实验 root@kr-soul.lytiao.com:/var/www/soul-party

2. 安装依赖并构建

# 在服务器上执行
cd /var/www/soul-party

# 安装依赖
npm install

# 构建生产版本
npm run build

3. 使用PM2启动服务

# 安装PM2（如果没有）
npm install -g pm2

# 启动服务
pm2 start npm --name "soul-party" -- start

# 设置开机自启
pm2 startup
pm2 save

4. 配置Nginx反向代理

创建Nginx配置文件：/etc/nginx/sites-available/soul-party

server {
    listen 80;
    server_name kr-soul.lytiao.com;
    
    # 强制跳转HTTPS
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl http2;
    server_name kr-soul.lytiao.com;
    
    # SSL证书配置
    ssl_certificate /path/to/your/cert.pem;
    ssl_certificate_key /path/to/your/key.pem;
    
    # API代理
    location /api {
        proxy_pass http://localhost:3000;
        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;
    }
    
    # 静态文件
    location / {
        proxy_pass http://localhost:3000;
        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;
    }
}

启用配置：

# 创建软链接
ln -s /etc/nginx/sites-available/soul-party /etc/nginx/sites-enabled/

# 测试配置
nginx -t

# 重启Nginx
systemctl restart nginx

小程序后台配置

1. 登录小程序后台

访问：https://mp.weixin.qq.com/

使用AppID wx0976665c3a3d5a7c 对应的账号登录

2. 配置服务器域名

开发管理 → 开发设置 → 服务器域名

添加以下域名：

request合法域名:
https://kr-soul.lytiao.com

uploadFile合法域名:
https://kr-soul.lytiao.com

downloadFile合法域名:
https://kr-soul.lytiao.com

⚠️ 注意：必须是HTTPS域名，HTTP会被拒绝！

3. 配置业务域名（可选）

如果需要在小程序内打开网页：

开发管理 → 开发设置 → 业务域名

添加：kr-soul.lytiao.com

📤 上传代码到微信后台

1. 上传代码

在微信开发者工具中：

  1. 点击工具栏 "上传" 按钮
  2. 填写版本号：1.0.0
  3. 填写项目备注：Soul派对小程序正式版
  4. 点击 "上传"

✅ 上传成功后，代码会出现在小程序后台

2. 提交审核

登录小程序后台：

  1. 版本管理 → 开发版本
  2. 找到刚上传的版本
  3. 点击 "提交审核"
  4. 填写审核信息：
    • 类别：图书/阅读
    • 标签：电子书、创业、私域运营
    • 功能说明：提供电子书阅读和分销功能

审核时间：通常1-3个工作日

3. 发布上线

审核通过后：

  1. 版本管理 → 审核版本
  2. 点击 "发布"
  3. 全量发布给所有用户

🎉 上线成功！

🔧 本地开发配置

方式1：使用本地API（推荐开发时）

文件: miniprogram/app.js

apiBase: 'http://localhost:3000/api'

然后在开发者工具中勾选 "不校验合法域名"

方式2：使用线上API

文件: miniprogram/app.js

apiBase: 'https://kr-soul.lytiao.com/api'

必须配置好HTTPS和域名白名单

📊 API接口测试

测试微信登录接口

curl -X POST http://kr-soul.lytiao.com/api/wechat/login \
  -H "Content-Type: application/json" \
  -d '{"code":"test_code"}'

测试章节列表接口

curl http://kr-soul.lytiao.com/api/book/latest-chapters

测试后台管理接口

curl http://kr-soul.lytiao.com/api/admin

🎨 生成小程序码

方式1：使用微信开发者工具

  1. 点击工具栏 "预览"
  2. 自动生成小程序码
  3. 用微信扫码即可预览

方式2：使用官方API生成

需要调用微信接口：

// 获取小程序码
POST https://api.weixin.qq.com/wxa/getwxacode?access_token=TOKEN

{
  "path": "pages/index/index",
  "width": 430
}

会生成二维码图片，保存后可分享

⚠️ 常见问题

Q1: 提示"不在以下request合法域名列表中"

解决：

  1. 开发时：勾选"不校验合法域名"
  2. 正式环境：在小程序后台配置域名白名单

Q2: API请求失败

检查清单：

  • 服务器是否启动？
  • 域名是否配置HTTPS？
  • 小程序后台是否配置域名？
  • API接口是否正常？

Q3: 登录失败

解决：

  1. 检查AppID和AppSecret是否正确
  2. 查看控制台错误信息
  3. 确认微信登录接口正常

📞 技术支持

联系方式

  • 项目路径: /Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验

快速命令

# 启动开发服务器
cd "/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验"
pnpm dev

# 构建生产版本
pnpm build

# 启动生产服务器
pnpm start

# 查看日志（如果使用PM2）
pm2 logs soul-party

✅ 配置完成清单

  • AppID配置完成
  • API地址配置完成
  • 微信登录接口创建完成
  • 书籍接口创建完成
  • 环境变量配置完成
  • 部署脚本创建完成
  • HTTPS证书配置（需要在服务器上操作）
  • 小程序后台域名配置（需要在微信后台操作）
  • 代码上传审核（需要在开发者工具操作）

🎉 下一步

  1. 本地测试 - 在开发者工具中测试所有功能
  2. 服务器部署 - 将代码部署到 kr-soul.lytiao.com
  3. 配置HTTPS - 申请并配置SSL证书
  4. 配置域名 - 在小程序后台配置服务器域名
  5. 提交审核 - 上传代码并提交审核
  6. 发布上线 - 审核通过后发布

祝部署顺利！ 🚀