5.7 KiB
小程序环境配置统一使用域名访问 Implementation Plan
For agentic workers: REQUIRED: Use superpowers:subagent-driven-development (if subagents available) or superpowers:executing-plans to implement this plan. Steps use checkbox (
- [ ]) syntax for tracking.
Goal: 修改小程序所有环境配置文件，统一使用域名 lifescript.happylifeos.com 通过 HTTPS/WSS 协议访问服务器后端 API。
Architecture: 修改 .env.development、.env.test、.env.production 三个环境配置文件，将 API 和 WebSocket 地址从 localhost/IP 地址改为域名访问，使用 HTTPS 和 WSS 加密协议。
Tech Stack: UniApp, Vite, 环境变量配置
Chunk 1: 环境配置文件修改
Task 1: 修改开发环境配置 (.env.development)
Files:
-
Modify:
mini-program/.env.development -
Step 1: 修改 .env.development 文件内容
将以下内容：
VITE_APP_ENV=dev
VITE_API_BASE_URL=http://localhost:19089/api
VITE_WS_URL=ws://localhost:19089
VITE_DEBUG=true
修改为：
# 开发环境配置（本地开发调试）
VITE_APP_ENV=dev
VITE_API_BASE_URL=https://lifescript.happylifeos.com/api
VITE_WS_URL=wss://lifescript.happylifeos.com/ws
VITE_DEBUG=true
- Step 2: 验证文件格式正确
确认文件内容没有多余的空格或格式问题
- Step 3: 提交更改
git add mini-program/.env.development
git commit -m "fix: 开发环境配置改为域名访问 (HTTPS/WSS)"
Task 2: 修改测试环境配置 (.env.test)
Files:
-
Modify:
mini-program/.env.test -
Step 1: 修改 .env.test 文件内容
将以下内容：
# 体验环境配置（小程序体验版）
VITE_APP_ENV=test
VITE_API_BASE_URL=http://101.200.208.45:19089/api
VITE_WS_URL=ws://101.200.208.45:19089
VITE_DEBUG=true
修改为：
# 测试环境配置（小程序体验版）
VITE_APP_ENV=test
VITE_API_BASE_URL=https://lifescript.happylifeos.com/api
VITE_WS_URL=wss://lifescript.happylifeos.com/ws
VITE_DEBUG=true
- Step 2: 验证文件格式正确
确认文件内容没有多余的空格或格式问题
- Step 3: 提交更改
git add mini-program/.env.test
git commit -m "fix: 测试环境配置改为域名访问 (HTTPS/WSS)"
Task 3: 修改生产环境配置 (.env.production)
Files:
-
Modify:
mini-program/.env.production -
Step 1: 修改 .env.production 文件内容
将以下内容（注意：当前文件第一行是 VITE_APP_ENV=prod 但文件名是 production，需确认内容）：
VITE_APP_ENV=prod
VITE_API_BASE_URL=http://101.200.208.45:19089/api
VITE_WS_URL=ws://101.200.208.45:19089
VITE_DEBUG=false
修改为：
# 生产环境配置（小程序正式版）
VITE_APP_ENV=prod
VITE_API_BASE_URL=https://lifescript.happylifeos.com/api
VITE_WS_URL=wss://lifescript.happylifeos.com/ws
VITE_DEBUG=false
- Step 2: 验证文件格式正确
确认文件内容没有多余的空格或格式问题
- Step 3: 提交更改
git add mini-program/.env.production
git commit -m "fix: 生产环境配置改为域名访问 (HTTPS/WSS)"
Chunk 2: 代码验证和文档更新
Task 4: 验证环境配置代码兼容性
Files:
-
Read:
mini-program/src/config/env.js -
Read:
mini-program/src/utils/env.ts -
Step 1: 检查 src/config/env.js 文件
确认文件中的配置逻辑能够正确处理 HTTPS 和 WSS 协议地址
预期：该文件只是读取环境变量，不需要修改
- Step 2: 检查 src/utils/env.ts 文件
确认请求封装代码能够正确处理 HTTPS 和 WSS 协议地址
预期：该文件使用 API_BASE_URL 拼接请求地址，不需要修改
- Step 3: 提交验证结果
如果代码不需要修改，跳过提交
Task 5: 更新 README.md 文档
Files:
-
Modify:
mini-program/README.md -
Step 1: 更新环境配置说明
将环境配置表格更新为：
| 文件 | 说明 | API 地址 | WebSocket 地址 |
|------|------|----------|----------------|
| `.env.development` | 开发环境配置 | https://lifescript.happylifeos.com/api | wss://lifescript.happylifeos.com/ws |
| `.env.test` | 测试环境配置 | https://lifescript.happylifeos.com/api | wss://lifescript.happylifeos.com/ws |
| `.env.production` | 生产环境配置 | https://lifescript.happylifeos.com/api | wss://lifescript.happylifeos.com/ws |
- Step 2: 更新各环境配置示例
将三个环境的配置示例都更新为使用域名的格式
- Step 3: 提交更改
git add mini-program/README.md
git commit -m "docs: 更新环境配置文档说明"
Task 6: 验证小程序编译
Files:
-
Build Output:
mini-program/unpackage/dist/test/mp-weixin -
Step 1: 执行测试环境编译
cd mini-program
npm run build:mp-weixin:test
预期：编译成功，无错误
- Step 2: 验证编译产物中的环境变量
检查编译后的文件中环境变量是否正确注入
预期：API_BASE_URL 和 WS_URL 应为域名地址
- Step 3: 提交验证
如果编译成功，记录验证结果
验证步骤
完成所有任务后，执行以下验证：
- 配置验证: 确认三个环境配置文件都已更新为域名访问
- 编译验证: 确认小程序可以正常编译
- 代码验证: 确认现有代码能够正确处理 HTTPS/WSS 地址
注意事项
- 所有环境都使用 HTTPS/WSS 协议，微信小程序要求加密连接
- 开发环境也使用服务器 API，本地无需启动后端服务
- 确保服务器 CORS 配置允许小程序域名访问
- 确保服务器 Nginx 配置了正确的 SSL 证书