2G 内存云服务器部署 Spring Boot + MySQL 实战:从踩坑到上线

2G 内存云服务器部署 Spring Boot + MySQL 实战:从踩坑到上线
前言
最近把自己的全栈博客项目部署到了腾讯云的入门级服务器(2核2G),过程中踩了不少坑。本文记录完整的部署过程和问题排查思路,希望对同样在小规格服务器上部署 Java 项目的同学有所帮助。
项目技术栈:
- 后端:Java 17 + Spring Boot 3.2.3 + Spring Security + JPA
- 数据库:MySQL 8.0
- 前端:Flutter Web
- 反向代理:Nginx 1.26
- 容器:Docker 28.4
服务器配置:
- 腾讯云轻量应用服务器
- 2 核 CPU / 2GB 内存 / 50GB 磁盘
- TencentOS Server 4 (x86_64)
一、方案一:Docker Compose 全容器化(失败)
1.1 docker-compose.yml
最初的方案是标准的全容器化部署:
services:db:image: mysql:8.0environment:MYSQL_ROOT_PASSWORD: ${DB_ROOT_PASSWORD}MYSQL_DATABASE: vonblog MYSQL_USER: vonblog MYSQL_PASSWORD: ${DB_PASSWORD}ports:-"3306:3306"volumes:- mysql_data:/var/lib/mysql healthcheck:test:["CMD","mysqladmin","ping","-h","localhost"]interval: 10s timeout: 5s retries:5backend:build: ./backend depends_on:db:condition: service_healthy ports:-"8080:8080"environment:SPRING_DATASOURCE_URL: jdbc:mysql://db:3306/vonblog?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/ShanghaiSPRING_DATASOURCE_USERNAME: vonblog SPRING_DATASOURCE_PASSWORD: ${DB_PASSWORD}nginx:image: nginx:alpine depends_on:- backend ports:-"80:80"-"443:443"1.2 问题现象
后端容器反复报错:
com.mysql.cj.jdbc.exceptions.CommunicationsException: Communications link failure Caused by: java.net.ConnectException: Connection refused 1.3 排查过程
逐项排查:
# 1. MySQL 容器状态 — 正常docker compose ps# db: Up 18 minutes (healthy)# 2. DNS 解析 — 正常dockerexec vonblog-backend-1 nslookup db # Address: 172.19.0.2# 3. MySQL 用户权限 — 已授权dockerexec vonblog-db-1 mysql -uroot-p-e"GRANT ALL ON vonblog.* TO 'vonblog'@'%';"# 4. 端口监听 — MySQL 确实在监听dockerexec vonblog-db-1 ss -tlnp|grep3306一切看起来都正常,但后端就是连不上。
1.4 根因分析
2GB 内存是瓶颈。
用 free -h 一看:
total used free shared buff/cache available Mem: 1.9Gi 588Mi 643Mi 8.0Mi 916Mi 1.3Gi MySQL 8.0 默认配置下内存占用约 400-500MB,Spring Boot JVM 默认堆大小也是几百 MB。两个容器同时启动,加上 Docker 本身的开销,内存直接见底。
在内存不足的情况下,容器间的网络通信会出现各种诡异问题:TCP 连接建立失败、超时、被内核 OOM killer 干掉后重启等。Connection refused 只是表象,本质是资源不足。
二、方案二:混合部署(成功)
2.1 架构调整
┌─────────────────────────────────────┐ │ 腾讯云 2C2G 服务器 │ │ │ │ ┌───────────┐ ┌────────────────┐ │ │ │ Docker │ │ 宿主机 │ │ │ │ MySQL 8.0 │ │ Java 17 (jar) │ │ │ │ (容器) │ │ Nginx (systemd)│ │ │ └───────────┘ └────────────────┘ │ │ ↑ 3306 ↑ 8080 ↑ 80 │ │ └──── 127.0.0.1 ────────┘ │ └─────────────────────────────────────┘ 核心思路:MySQL 留在 Docker(数据隔离方便),Spring Boot 和 Nginx 直接跑在宿主机上(省内存)。
2.2 步骤一:启动 MySQL 容器
docker run -d\--name vonblog-mysql \--restart always \-eMYSQL_ROOT_PASSWORD=YourRootPassword \-eMYSQL_DATABASE=vonblog \-eMYSQL_USER=vonblog \-eMYSQL_PASSWORD=YourDbPassword \-p3306:3306 \-v mysql_data:/var/lib/mysql \ mysql:8.0 \ --character-set-server=utf8mb4 \ --collation-server=utf8mb4_unicode_ci 2.3 步骤二:安装 Java 17
# TencentOS / CentOS / RHEL 系 yum install-y java-17-openjdk-headless # 验证java-version# openjdk version "17.0.18"2.4 步骤三:运行 Spring Boot jar
关键:限制 JVM 堆内存,2G 服务器不能让 JVM 随意扩张。
mkdir-p /opt/vonblog/uploads nohupjava-Xms256m-Xmx512m\-jar /opt/vonblog/app.jar \--spring.profiles.active=prod \--spring.datasource.url="jdbc:mysql://127.0.0.1:3306/vonblog?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true&useSSL=false"\--spring.datasource.username=vonblog \--spring.datasource.password=YourDbPassword \> /opt/vonblog/app.log 2>&1&echo"PID: $!"注意几个要点:
-Xms256m -Xmx512m:堆内存限制在 256-512MB,给系统和 MySQL 留空间127.0.0.1:3306:通过宿主机 loopback 连接 Docker 映射出来的端口allowPublicKeyRetrieval=true:MySQL 8.0 默认使用caching_sha2_password,需要这个参数
2.5 步骤四:配置 Nginx
yum install-y nginx cat> /etc/nginx/conf.d/vonblog.conf <<'EOF' server { listen 80; server_name _; client_max_body_size 10M; # 前端静态文件 root /opt/vonblog/web; index index.html; # API 反代 location /api/ { proxy_pass http://127.0.0.1:8080/api/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } # 上传文件 location /uploads/ { alias /opt/vonblog/uploads/; expires 30d; } # Flutter Web SPA 路由 location / { try_files $uri $uri/ /index.html; } } EOF systemctl enable nginx systemctl start nginx try_files $uri $uri/ /index.html 这行很重要——Flutter Web 是 SPA 单页应用,所有路由都要回落到 index.html,否则刷新页面会 404。
2.6 效果
# 启动耗时 Started VonBlogApplication in10.393 seconds # 内存占用free-h# Mem: 1.9Gi total, ~400Mi free, ~1.1Gi used (含 buff/cache)# MySQL 容器约 300MB + JVM 约 400MB + Nginx 约 20MB + 系统约 300MB刚好塞下,不富裕但够用。
三、前端文件传输的曲折
3.1 SCP 被断连
本地 flutter build web --release 构建完后用 SCP 上传,结果:
Connection closed by 118.x.x.x port 22 反复尝试都被断。原因是之前多次 SSH 密码交互触发了服务器的入侵防护策略(fail2ban 或类似机制)。
3.2 解决方案:临时 HTTP 上传服务
在服务器上用 Python 起一个临时的文件接收服务:
# 服务端(服务器上执行) python3 -c " import http.server, os classH(http.server.BaseHTTPRequestHandler):defdo_PUT(self): length =int(self.headers['Content-Length'])withopen('/opt/vonblog/web.tar.gz','wb')as f: f.write(self.rfile.read(length)) self.send_response(200) self.end_headers() self.wfile.write(b'OK') os._exit(0)# 接收完自动退出 http.server.HTTPServer(('0.0.0.0',9999), H).serve_forever() " &# 客户端(本地执行)tar-czf web.tar.gz web/ curl-X PUT --data-binary @web.tar.gz http://服务器IP:9999/upload # 服务端解压cd /opt/vonblog &&tar-xzf web.tar.gz 7.8MB 的压缩包,3 秒传完。简单粗暴但有效。
⚠️ 注意:这个方案没有任何认证,仅适合临时使用,用完立即关闭端口或进程。
四、内存优化建议
如果你也在 2G 服务器上跑 Java 项目,这些参数值得关注:
4.1 JVM 参数
# 严格限制堆内存-Xms256m-Xmx512m# 如果更紧张,可以进一步压缩-Xms128m-Xmx256m# 使用 G1GC(Java 17 默认),低延迟友好-XX:+UseG1GC4.2 MySQL 内存调优
如果 MySQL 也要省内存,可以在启动时追加参数:
docker run ... mysql:8.0 \ --innodb-buffer-pool-size=128M \ --max-connections=50\ --table-open-cache=2004.3 Swap 兜底
2G 内存的服务器强烈建议开 Swap:
fallocate -l 2G /swapfile chmod600 /swapfile mkswap /swapfile swapon /swapfile echo'/swapfile none swap sw 0 0'>> /etc/fstab 有 Swap 兜底,偶发的内存峰值不会直接触发 OOM killer。
五、待优化
- systemd 服务化:目前后端用
nohup启动,服务器重启后不会自动恢复。应该写一个 systemd service 文件。 - HTTPS:用 Let’s Encrypt + certbot 配置免费 SSL 证书。
- 日志轮转:
app.log会无限增长,需要配置 logrotate。 - 监控:没有任何监控,进程挂了无感知。至少应该加个健康检查脚本 + crontab。
总结
| 方案 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
| Docker Compose 全容器 | 环境隔离、一键部署 | 内存开销大 | 4G+ 内存服务器 |
| 混合部署 | 省内存、连接稳定 | 管理稍复杂 | 2G 内存服务器 |
| 全宿主机 | 最省资源 | 环境污染 | 1G 极端场景 |
核心结论:小规格服务器不要迷信全容器化,够用就行。 Docker Compose 在 4G 以上内存的机器上体验很好,但在 2G 机器上,混合方案是更务实的选择。
本文基于实际项目部署经验撰写,项目技术栈:Spring Boot 3.2.3 + Flutter Web + MySQL 8.0 + Nginx + Docker
如有疑问欢迎评论交流。