4.5 KiB
4.5 KiB
配置指南
本文档说明如何配置海外预约小程序的各项参数。
API 配置
开发环境
Config.API_BASE_URL = 'http://localhost:3000'
生产环境
部署到生产环境时,需要修改为实际的服务器地址:
Config.API_BASE_URL = 'https://your-domain.com'
上传配置
上传服务类型
项目支持多种上传方式:
-
server - 本地服务器上传(推荐开发环境使用)
Config.UPLOAD_SERVICE_TYPE = 'server' -
cos - 腾讯云 COS 对象存储
Config.UPLOAD_SERVICE_TYPE = 'cos' Config.UPLOAD_CONFIG.cosDomain = 'https://your-bucket.cos.region.myqcloud.com' -
aliyun - 阿里云 OSS 对象存储
Config.UPLOAD_SERVICE_TYPE = 'aliyun' -
qiniu - 七牛云存储
Config.UPLOAD_SERVICE_TYPE = 'qiniu'
上传限制配置
Config.UPLOAD_CONFIG = {
imageQuality: 80, // 图片压缩质量 (0-100)
imageMaxSize: 5 * 1024 * 1024, // 图片最大 5MB
videoMaxSize: 50 * 1024 * 1024 // 视频最大 50MB
}
不同场景的上传预设
Config.UPLOAD_PRESETS = {
normal: {
imageQuality: 80,
imageMaxSize: 5 * 1024 * 1024 // 普通图片 5MB
},
avatar: {
imageQuality: 90,
imageMaxSize: 2 * 1024 * 1024 // 头像 2MB
},
qrcode: {
imageQuality: 85,
imageMaxSize: 3 * 1024 * 1024 // 收款码 3MB
}
}
业务配置
送花时间间隔
Config.FLOWER_SEND_INTERVAL = 60 * 60 * 1000; // 1小时
环境切换
方法一:手动修改
直接修改 modules/Config.js 文件中的配置。
方法二:条件编译(推荐)
使用 uni-app 的条件编译功能:
// #ifdef MP-WEIXIN
Config.API_BASE_URL = 'https://production-api.com'
// #endif
// #ifdef H5
Config.API_BASE_URL = 'http://localhost:3000'
// #endif
方法三:环境变量
创建不同的配置文件:
Config.dev.js (开发环境)
export default {
API_BASE_URL: 'http://localhost:3000',
UPLOAD_SERVICE_TYPE: 'server'
}
Config.prod.js (生产环境)
export default {
API_BASE_URL: 'https://api.your-domain.com',
UPLOAD_SERVICE_TYPE: 'cos'
}
然后在 Config.js 中根据环境导入:
import DevConfig from './Config.dev.js'
import ProdConfig from './Config.prod.js'
const Config = process.env.NODE_ENV === 'production' ? ProdConfig : DevConfig
后端配置
后端配置文件位于 backend/.env,主要配置项:
# 服务器端口
PORT=3000
# 数据库配置
DB_HOST=localhost
DB_PORT=3306
DB_NAME=overseas_appointment
DB_USER=root
DB_PASSWORD=your_password
# Redis配置
REDIS_HOST=localhost
REDIS_PORT=6379
# JWT密钥
JWT_SECRET=your-secret-key
JWT_EXPIRES_IN=7d
# 微信小程序配置
WECHAT_APP_ID=your_app_id
WECHAT_APP_SECRET=your_app_secret
# 文件上传配置
UPLOAD_PATH=./uploads
MAX_FILE_SIZE=5242880
部署检查清单
部署到生产环境前,请确认以下配置:
- 修改
Config.API_BASE_URL为生产环境地址 - 配置正确的上传服务类型和参数
- 后端
.env文件配置正确的数据库连接 - 后端
.env文件配置正确的 Redis 连接 - 后端
.env文件配置正确的微信小程序 AppID 和 AppSecret - 后端
JWT_SECRET使用强密码 - 检查文件上传路径和权限
- 配置 HTTPS 证书(生产环境必须)
- 配置 CORS 允许的域名
- 设置合适的速率限制参数
常见问题
Q: 为什么登录失败?
A: 检查以下几点:
Config.API_BASE_URL是否正确- 后端服务是否正常运行
- 微信小程序 AppID 和 AppSecret 是否配置正确
- 网络是否可以访问后端服务
Q: 图片上传失败?
A: 检查以下几点:
- 图片大小是否超过限制
- 上传服务类型配置是否正确
- 如果使用云存储,检查密钥配置
- 检查后端上传目录权限
Q: 如何在开发环境使用真实的后端服务?
A: 修改 Config.API_BASE_URL 为后端服务器的实际地址,例如:
Config.API_BASE_URL = 'http://192.168.1.100:3000'
Q: 如何配置多个环境(开发、测试、生产)?
A: 建议使用环境变量或条件编译,参考上面的"环境切换"章节。
技术支持
如有问题,请查看:
- 后端 API 文档: http://localhost:3000/api-docs/
- API 使用指南:
modules/api/API_GUIDE.md - 后端 README:
backend/README.md