生产部署
打包运行
bash
./gradlew build # 生成 lemon-admin/build/libs/lemon-ecom.jar
cd lemon-web && npm ci && npm run build # 生成 lemon-web/dist,交给 Nginx 托管bash
# 生产环境配置全部取环境变量(application-prod.yml 没有默认值)
export DB_URL=... DB_USERNAME=... DB_PASSWORD=... REDIS_HOST=... REDIS_PASSWORD=...
export JWT_SECRET=$(openssl rand -base64 48) # 只生成一次并妥善保存
export LEMON_ECOM_PUBLIC_URL=https://erp.example.com/api
java -jar lemon-ecom.jar --spring.profiles.active=prod也可以直接下载 Release 中的 lemon-ecom-<版本>.jar、lemon-web-<版本>.zip 和 init.sql。
MySQL 与 Redis
- MySQL 8.0+,字符集
utf8mb4:
bash
mysql -uroot -p -e "CREATE DATABASE lemon_ecom DEFAULT CHARSET utf8mb4"
mysql -uroot -p lemon_ecom < sql/init.sql # 会删除并重建全部表,只在新库执行- Flowable 的
ACT_*表由后端启动时自动创建;DB_URL必须带nullCatalogMeansCurrent=true。 - Redis 6.2+,用于会话、权限、字典、业务参数等缓存。多实例部署必须用 Redis(
lemon.cache.type: redis)。 - 演示数据的生成进度保存在内存中,多实例时只在一个实例上触发。
Nginx
nginx
server {
listen 443 ssl;
server_name erp.example.com;
location / {
root /path/to/lemon-web/dist;
try_files $uri $uri/ /index.html;
}
# AI 问数的流式回答需要关闭缓冲
location /api/ai/ {
proxy_pass http://127.0.0.1:8080;
proxy_buffering off;
proxy_read_timeout 300s;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
location /api/ {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
client_max_body_size 50m; # 导入结算报告、上传图片
}
}- 后端开启了
server.forward-headers-strategy: native,只信任内网代理传来的X-Forwarded-For;代理不在内网时用server.tomcat.remoteip.internal-proxies配置。 - OAuth 回调(
/api/ecom/oauth/callback/)和商品图片(/api/files/)需要能从公网访问。
文件与备份
| 内容 | 位置 | 备份 |
|---|---|---|
| 数据库 | MySQL lemon_ecom | 每天 mysqldump,含 ACT_* 表 |
| 商品图片、头像 | lemon.upload.path(默认 ./uploads) | 与数据库一起备份 |
| 附件、面单 | lemon.upload.attachment-path(默认 ./attachments) | 与数据库一起备份 |
JWT_SECRET | 环境变量 | 丢失后所有授权需要重新填写 |
上线检查清单
JWT_SECRET已设置为随机强密钥并妥善保存;数据库、Redis 使用强密码且不对公网开放。- 修改了
admin、test的默认密码(或停用test);在「参数设置」中开启登录验证码和密码策略。 LEMON_ECOM_DEMO_DATA=false,正式库中没有DEMO-开头的演示店铺。- 配置了
LEMON_ECOM_PUBLIC_URL,各 OAuth 平台登记了回调地址,后端可以访问外网。 - 在「财务管理 → 币种汇率」中维护了店铺结算币种的月汇率(没有汇率时订单无法折算本位币)。
- 在「系统监控 → 定时任务」中确认订单同步、库存回传等任务已启用,Cron 符合需要。
- 正式接入的平台、海外仓、物流商已用真实账号联调。