〔部署全景〕java代码部署到服务器全流程概览
在现代互联网应用开发中,java代码部署到服务器已成为开发者日常工作的关键环节。部署过程看似简单,实则涉及环境配置、资源规划、安全加固、故障容错等多个维度。本文将从零开始,系统梳理主流部署方式的技术要点与最佳实践,帮助开发者构建完整、可复用的部署知识体系。
部署并非仅是“把jar扔到服务器上运行”,而是贯穿应用生命周期的系统工程。一个完整的部署流程通常包括以下阶段:
- 环境准备(JDK版本、系统依赖)
- 应用打包(Maven/Gradle构建)
- 服务部署(物理机/虚拟机/容器)
- 负载均衡与反向代理配置
- HTTPS证书部署与安全加固
- 日志采集与监控告警
- 自动化部署流水线(CI/CD)
- 故障排查与性能调优
无论采用传统部署、容器化部署,还是混合架构,核心目标始终如一:稳定、高效、可维护。
- 确认服务器操作系统版本(CentOS 7/8、Ubuntu 20.04/22.04)
- 检查JDK版本与应用兼容性(JDK 8/11/17/21)
- 规划端口占用(8080、8443、80、443等)
- 配置防火墙规则(iptables/firewalld/UFW)
- 准备SSL证书(Let's Encrypt免费证书或商业CA证书)
- 设置时区与NTP时间同步(避免日志时间错乱)
- 创建独立运行用户(避免root运行应用)
当前主流部署方式可分为三类:原生部署(直接运行jar/war)、容器化部署(Docker/K8s)、Serverless部署(如阿里云SAE)。本文重点覆盖前两类, Serverless方案因平台依赖性强,将另文详解。
根据Stack Overflow 2024开发者调查,约68%的Java开发者在生产环境使用Spring Boot,其中74%选择容器化部署;而传统Tomcat部署仍占32%,多见于遗留系统迁移与中小规模项目。因此,掌握多种部署方式具有显著实践价值。
⚙️ JDK配置与版本选择
java代码部署到服务器的第一步,是正确安装与配置JDK。JDK版本直接影响应用性能、安全性及兼容性。截至2024年,主流生产环境推荐版本为JDK 8(长期支持)、JDK 11(LTS)、JDK 17(LTS),部分新项目已迁移到JDK 21(最新LTS)。
〔JDK 8〕稳定可靠,生态最广
JDK 8于2014年发布,是目前使用最广泛的Java版本。其优势在于:
- 绝大多数第三方库(如Spring Framework 4.x、Tomcat 8.x)兼容性最佳
- 社区支持完善,问题易查解法
- 无需额外授权(Oracle JDK商业授权自2019年起对生产环境收费)
安装命令(CentOS 7):
sudo yum install -y java-1.8.0-openjdk-devel java -version
预期输出:
openjdk version "1.8.0_412" OpenJDK Runtime Environment (build 1.8.0_412-b08) OpenJDK 64-Bit Server VM (build 25.412-b08, mixed mode)
若需指定版本为Oracle JDK,可从官网下载tar.gz包并手动配置:
tar -zxvf jdk-8u381-linux-x64.tar.gz -C /opt/ echo 'export JAVA_HOME=/opt/jdk1.8.0_381 export PATH=$JAVA_HOME/bin:$PATH' >> /etc/profile.d/java.sh source /etc/profile.d/java.sh
⚠️ 注意:自2019年起,Oracle JDK 8更新仅对付费用户开放。开源替代方案推荐使用Adoptium(Eclipse Temurin)或Amazon Corretto 8。
〔JDK 11〕现代化LTS版本
JDK 11于2018年发布,是首个在Oracle官方支持下长期维护的LTS版本(支持至2026年9月)。其显著特性包括:
- 移除Java EE及CORBA模块(需额外引入依赖)
- 新增Epsilon GC(无操作GC,适合测试)与ZGC(低延迟GC)
- 字符串API增强(
isBlank、lines等) - HttpClient正式标准化(替代过时的HttpURLConnection)
安装(Ubuntu 22.04):
sudo apt update sudo apt install -y openjdk-11-jdk update-alternatives --config java
推荐使用Adoptium Temurin 11,提供更稳定的构建版本:
wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo gpg --dearmor -o /usr/share/keyrings/adoptium.gpg
echo "deb [signed-by=/usr/share/keyrings/adoptium.gpg] https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/ {print $2}' /etc/os-release) main" | sudo tee /etc/apt/sources.list.d/adoptium.list
sudo apt update
sudo apt install -y temurin-11-jdk
兼容性验证:Spring Boot 2.6+、Spring Framework 5.3+、Tomcat 9/10均全面支持JDK 11。
〔JDK 17〕当前主流LTS
JDK 17于2021年发布,是当前生产环境最推荐的LTS版本(支持至2029年9月)。关键改进包括:
- 密封类(Sealed Classes)提升类型安全
- 模式匹配增强(instanceof instanceof)
- Record类简化不可变数据载体
- G1 GC默认启用Elastic Heap(减少内存碎片)
- 移除RMIClassLoaderSpi(需调整RMI应用)
部署前务必检查应用依赖是否兼容JDK 17。常见兼容性问题:
| 依赖库 | 最低兼容版本 | 注意项 |
|---|---|---|
| Spring Framework | 5.3.18+ | 5.3.x需升级至5.3.24+以避免JDK 17反射问题 |
| Hibernate | 5.4.32+ / 6.0+ | 6.x完全支持JDK 17,5.x需补丁 |
| Tomcat | 9.0.52+ / 10.1+ | 10.1为Jakarta EE 9实现(包名变更) |
安装(CentOS 8):
sudo dnf install -y temurin-17-jdk
〔JDK 21〕前沿LTS版本
JDK 21于2023年9月发布,是最新LTS版本(支持至2031年9月)。核心特性:
- 虚拟线程(Virtual Threads)提升高并发吞吐量
- 结构化并发(Structured Concurrency)简化多线程编程
- 模式匹配增强(switch instanceof)
- 记录模式(Record Patterns)支持深度解构
- 移除旧版安全提供程序(如MD5withRSA)
适用场景:高并发微服务、实时数据处理系统。但需评估应用依赖是否支持JDK 21。
例如:Spring Boot 3.2+ 需JDK 17+,完全兼容JDK 21;而Spring Boot 2.x需升级至2.7.18+(最后维护版)。
java -version验证实际运行版本,确保与编译版本一致。
〔Tomcat部署〕传统Web应用部署方案
尽管容器化成为趋势,Tomcat仍广泛用于中小型企业Web应用。其轻量、配置灵活,适合传统JSP/Servlet应用迁移。
以Tomcat 9.0.82为例(JDK 8/11兼容):
wget https://dlcdn.apache.org/tomcat/tomcat-9/v9.0.82/bin/apache-tomcat-9.0.82.tar.gz tar -zxvf apache-tomcat-9.0.82.tar.gz -C /opt/ mv /opt/apache-tomcat-9.0.82 /opt/tomcat9 useradd -r -s /bin/false tomcat chown -R tomcat:tomcat /opt/tomcat9
配置环境变量:
echo 'export CATALINA_HOME=/opt/tomcat9 export JAVA_HOME=/usr/lib/jvm/temurin-11-jdk export PATH=$CATALINA_HOME/bin:$JAVA_HOME/bin:$PATH' > /etc/profile.d/tomcat.sh source /etc/profile.d/tomcat.sh
编辑/opt/tomcat9/conf/server.xml,提升性能与安全性:
<Connector port="8080" protocol="org.apache.coyote.http11.Http11Nio2Protocol"
maxThreads="500" minSpareThreads="20"
connectionTimeout="20000"
disableUploadTimeout="true"
compression="on" compressionMinSize="2048"
noCompressionUserAgents="gozilla, traviata"
compressableMimeType="text/html,text/xml,text/plain,application/json"/>
将app.war放入/opt/tomcat9/webapps/,Tomcat自动解压部署。或修改conf/Catalina/localhost/ROOT.xml指定绝对路径:
<Context docBase="/data/webapps/myapp" privileged="true" />
启动服务:
su - tomcat -c "$CATALINA_HOME/bin/startup.sh"
创建/etc/systemd/system/tomcat.service:
[Unit] Description=Apache Tomcat Web Application Container After=network.target [Service] Type=forking User=tomcat Group=tomcat Environment="JAVA_HOME=/usr/lib/jvm/temurin-11-jdk" Environment="CATALINA_PID=/opt/tomcat9/temp/tomcat.pid" Environment="CATALINA_HOME=/opt/tomcat9" Environment="CATALINA_BASE=/opt/tomcat9" Environment="CATALINA_OPTS=-Xms512M -Xmx1024M -server -XX:+UseParallelGC" ExecStart=/opt/tomcat9/bin/startup.sh ExecStop=/opt/tomcat9/bin/shutdown.sh [Install] WantedBy=multi-user.target
启用服务:
systemctl daemon-reexec systemctl enable --now tomcat
manager、host-manager),删除conf/tomcat-users.xml中所有用户定义。生产环境应通过反向代理(如Nginx)暴露服务,避免直接暴露8080端口。
〔Spring Boot部署〕现代微服务标准
Spring Boot已成为Java Web应用事实标准。其内嵌Tomcat/Jetty/Undertow,简化部署流程,支持“一次构建,到处运行”。
① 可执行jar包部署
构建命令(Maven):
mvn clean package -DskipTests java -jar target/app-1.0.0.jar
后台运行(推荐):
nohup java -jar app-1.0.0.jar \ --spring.profiles.active=prod \ > /var/log/app/app.log 2>&1 &
systemd服务配置(/etc/systemd/system/app.service):
[Unit] Description=My Spring Boot Application After=network.target [Service] User=appuser WorkingDirectory=/opt/app ExecStart=/usr/bin/java -jar /opt/app/app-1.0.0.jar SuccessExitStatus=143 Restart=on-failure RestartSec=5 StandardOutput=append:/var/log/app/app.log StandardError=append:/var/log/app/app-error.log [Install] WantedBy=multi-user.target
配置应用配置文件application-prod.yml:
server:
port: 8080
servlet:
context-path: /api
spring:
datasource:
url: jdbc:mysql://db.example.com:3306/appdb?useSSL=false&serverTimezone=UTC
username: appuser
password: ${DB_PASSWORD}
jpa:
hibernate:
ddl-auto: none
properties:
hibernate:
format_sql: true
⚠️ 注意:生产环境务必设置DB_PASSWORD环境变量,禁止硬编码密码。
② 传统war包部署(兼容Tomcat)
修改pom.xml:
<packaging>war</packaging> ... <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-tomcat</artifactId> <scope>provided</scope> </dependency>
主类继承SpringBootServletInitializer:
@SpringBootApplication
public class Application extends SpringBootServletInitializer {
@Override
protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
return application.sources(Application.class);
}
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
构建后将target/app.war放入Tomcatwebapps/目录。
③ Docker镜像构建与部署
Dockerfile(多阶段构建):
FROM maven:3.8.8-eclipse-temurin-17-alpine AS build WORKDIR /build COPY pom.xml . RUN mvn -B dependency:go-offline COPY src ./src RUN mvn -B package -DskipTests FROM eclipse-temurin:17-jre-alpine WORKDIR /app COPY --from=build /build/target/*.jar app.jar EXPOSE 8080 ENTRYPOINT ["java","-Duser.timezone=Asia/Shanghai","-jar","app.jar"]
构建与运行:
docker build -t myapp:1.0 . docker run -d --name app \ -p 8080:8080 \ -e SPRING_PROFILES_ACTIVE=prod \ -e DB_PASSWORD=secret123 \ myapp:1.0
生产环境推荐JVM参数(根据服务器内存调整):
-Xms512m -Xmx1024m -XX:+UseG1GC -XX:MaxGCPauseMillis=200 -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/var/log/app/heapdump.hprof
启用Actuator监控端点:
management:
endpoints:
web:
exposure:
include: health,info,metrics
endpoint:
health:
show-details: always
〔Docker容器化部署〕标准化交付
Docker通过容器化技术实现环境一致性,显著降低“在我机器上能跑”问题。结合Docker Compose可快速搭建多容器应用。
CentOS 7/8安装(使用官方脚本):
curl -fsSL https://get.docker.com | sh systemctl enable --now docker
验证安装:
docker version docker run hello-world
以Spring Boot应用为例:
docker build -t myapp:1.0.0 . docker images
推荐使用多阶段构建减少镜像体积(见前文Spring Boot Docker部分)。
单容器运行:
docker run -d --name myapp \ -p 8080:8080 \ -e SPRING_DATASOURCE_URL=jdbc:mysql://db:3306/app \ -v /var/log/app:/var/log/app \ myapp:1.0.0
通过--network指定自定义网络,实现容器间通信:
docker network create app-net docker run -d --name mysql --network app-net mysql:8.0 docker run -d --name myapp --network app-net myapp:1.0.0
创建docker-compose.yml:
version: '3.8'
services:
app:
image: myapp:1.0.0
ports:
- "8080:8080"
environment:
SPRING_PROFILES_ACTIVE: prod
SPRING_DATASOURCE_URL: jdbc:mysql://db:3306/app
depends_on:
- db
volumes:
- app_logs:/var/log/app
db:
image: mysql:8.0
environment:
MYSQL_DATABASE: app
MYSQL_ROOT_PASSWORD: rootpass
volumes:
- db_data:/var/lib/mysql
volumes:
app_logs:
db_data:
启动服务:
docker-compose up -d
- 禁用容器以root运行(Dockerfile中添加
USER appuser) - 使用非root用户构建镜像
- 定期扫描镜像漏洞(
docker scan或Trivy) - 限制容器资源(
--memory、--cpus) - 启用日志驱动(
--log-driver json-file --log-opt max-size=10m --log-opt max-file=3)
〔Kubernetes部署〕云原生编排
Kubernetes(K8s)提供容器编排、自动扩缩容、服务发现等能力,适合中大型微服务集群。
① 基础Deployment与Service
app-deployment.yaml:
apiVersion: apps/v1
kind: Deployment
metadata:
name: java-app
spec:
replicas: 3
selector:
matchLabels:
app: java-app
template:
metadata:
labels:
app: java-app
spec:
containers:
- name: app
image: myregistry/myapp:1.0.0
ports:
- containerPort: 8080
env:
- name: SPRING_PROFILES_ACTIVE
value: "prod"
resources:
requests:
memory: "512Mi"
cpu: "250m"
limits:
memory: "1Gi"
cpu: "500m"
livenessProbe:
httpGet:
path: /actuator/health/liveness
port: 8080
initialDelaySeconds: 30
periodSeconds: 10
readinessProbe:
httpGet:
path: /actuator/health/readiness
port: 8080
initialDelaySeconds: 10
periodSeconds: 5
app-service.yaml:
apiVersion: v1
kind: Service
metadata:
name: java-app-service
spec:
selector:
app: java-app
ports:
- protocol: TCP
port: 80
targetPort: 8080
type: ClusterIP
应用部署:
kubectl apply -f app-deployment.yaml kubectl apply -f app-service.yaml kubectl rollout status deployment/java-app
② Helm Chart快速部署
创建Chart结构:
helm create java-app
tree java-app/
java-app/
├── Chart.yaml
├── values.yaml
└── templates/
├── deployment.yaml
└── service.yaml
修改values.yaml:
replicaCount: 3 image: repository: myregistry/myapp tag: "1.0.0" containerPort: 8080 service: type: ClusterIP port: 80 env: SPRING_PROFILES_ACTIVE: prod
部署:
helm install java-app ./java-app \ --set env.DB_PASSWORD=secret123
〔Nginx反向代理〕生产级流量入口
Nginx作为高性能HTTP服务器与反向代理,是Java应用生产环境必备组件,用于负载均衡、静态资源处理、SSL终止。
CentOS:
yum install -y nginx systemctl enable --now nginx
/etc/nginx/conf.d/app.conf:
upstream java_app {
server 127.0.0.1:8080 weight=1 max_fails=3 fail_timeout=30s;
}
server {
listen 80;
server_name www.example.com;
location / {
proxy_pass http://java_app;
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;
proxy_connect_timeout 30s;
proxy_send_timeout 60s;
proxy_read_timeout 60s;
}
location /static/ {
alias /var/www/app/static/;
expires 30d;
add_header Cache-Control "public, immutable";
}
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root /usr/share/nginx/html;
}
}
重载配置:
nginx -t && nginx -s reload
多后端节点部署:
upstream java_app {
least_conn;
server 192.168.1.10:8080 weight=2;
server 192.168.1.11:8080 weight=1;
server 192.168.1.12:8080 backup;
}
- 启用Gzip压缩(
gzip on; gzip_types text/plain application/json;) - 设置连接池(
keepalive 32;) - 限制请求速率(
limit_req zone=one burst=10;) - 启用HTTP/2(
listen 443 ssl http2;)
〔HTTPS配置〕安全传输保障
HTTPS通过TLS/SSL加密传输,防止中间人攻击。Let's Encrypt提供免费证书,是生产环境首选方案。
使用Certbot(CentOS):
yum install -y certbot python3-certbot-nginx certbot --nginx -d www.example.com -d example.com
自动配置Nginx并设置自动续期(每90天):
systemctl enable --now certbot.timer
/etc/nginx/conf.d/app-ssl.conf:
server {
listen 443 ssl http2;
server_name www.example.com;
ssl_certificate /etc/letsencrypt/live/www.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/www.example.com/privkey.pem;
ssl_trusted_certificate /etc/letsencrypt/live/www.example.com/chain.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 10m;
location / {
proxy_pass http://java_app;
...
}
}
# HTTP重定向到HTTPS
server {
listen 80;
server_name www.example.com;
return 301 https://$host$request_uri;
}
https://www.ssllabs.com/ssltest/检测,确保SSL评分≥A+。建议启用HSTS(add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;)。
〔监控与日志〕可观测性建设
生产环境必须建立完善监控体系,及时发现与定位问题。核心组件包括日志采集、指标监控、告警通知。
① 日志采集方案
推荐ELK(Elasticsearch + Logstash + Kibana)或EFK(Fluentd替代Logstash):
filebeat.inputs:
- type: filestream
paths:
- /var/log/app/*.log
fields:
app: java-app
env: prod
output.elasticsearch:
hosts: ["es-node1:9200"]
indices:
- index: "java-app-%{+yyyy.MM.dd}"
Spring Boot日志格式优化(logback-spring.xml):
<appender name="JSON" class="ch.qos.logback.classic.net.SyslogAppender">
<syslogFacility>local0</syslogFacility>
<layout class="ch.qos.logback.classic.PatternLayout">
<pattern>{"timestamp":"%d{ISO8601}", "level":"%level", "thread":"%thread", "logger":"%logger", "message":"%m", "exception":"%ex"}</pattern>
</layout>
</appender>
使用GELF格式便于Graylog解析。
② 指标监控
集成Micrometer + Prometheus:
<dependency> <groupId>io.micrometer</groupId> <artifactId>micrometer-registry-prometheus</artifactId> </dependency>
Prometheus配置:
- job_name: 'java-app'
metrics_path: /actuator/prometheus
static_configs:
- targets: ['app-service:8080']
Kibana或Grafana可视化:
- JVM内存使用(heap/non-heap)
- GC次数与耗时
- HTTP请求速率、延迟分布
- 数据库连接池状态
- 自定义业务指标(如订单创建数)
③ 告警配置
Prometheus Alertmanager配置:
alerting:
alertmanagers:
- static_configs:
- targets: ["alertmanager:9093"]
rule_files:
- /etc/prometheus/rules/*.yml
规则文件rules/java-alerts.yml:
- alert: HighGC pause
expr: jvm_gc_pause_seconds{app="java-app"} > 0.5
for: 5m
labels:
severity: warning
annotations:
summary: "GC暂停时间过高"
description: "应用{{ $labels.instance }} GC暂停时间超过500ms"
集成企业微信/钉钉/Slack通知。
每日检查项:
- 应用健康状态(
/actuator/health) - JVM内存使用率(堆/非堆)
- GC频率与暂停时间
- 数据库连接池活跃/空闲连接数
- 磁盘空间(日志目录)
- SSL证书有效期(
openssl s_client -connect example.com:443 | openssl x509 -noout -dates)
〔故障排查〕典型问题与解决方案
部署后常见问题及定位方法:
① HTTP 500内部服务器错误
排查步骤:
- 检查应用日志(
tail -f /var/log/app/app.log) - 确认Spring Boot配置(
application-prod.yml) - 验证数据库连接(
telnet db.example.com 3306) - 检查权限(
/var/log/app目录写权限)
常见原因:
- 配置文件缺失/路径错误
- 数据库密码错误(环境变量未传递)
- 数据库驱动缺失(如MySQL 8需
mysql-connector-java 8.0+) - JVM参数冲突(如
-Xmx超过物理内存)
② 502 Bad Gateway(Nginx)
排查步骤:
- 测试后端服务是否存活(
curl http://127.0.0.1:8080/actuator/health) - 检查Nginx upstream配置(IP/端口是否正确)
- 调整代理超时(
proxy_read_timeout) - 查看Nginx错误日志(
tail -f /var/log/nginx/error.log)
典型日志:
upstream prematurely closed connection while reading response header from upstream
解决方案:增加proxy_read_timeout 120s;或优化应用启动时间。
③ 响应缓慢
诊断工具:
- JVM线程dump(
jstack <pid>) - JVM堆dump(
jmap -dump:format=b,file=heap.hprof <pid>) - 网络分析(
tcpdump -i eth0 port 8080) - 应用性能监控(APM工具如SkyWalking、Pinpoint)
常见瓶颈:
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 高CPU使用率 | 死循环、频繁GC | 分析线程dump;调整JVM参数 |
| 高内存使用 | 内存泄漏、堆外内存 | 分析堆dump;检查DirectByteBuffer |
| 高IO等待 | 磁盘慢、数据库慢查询 | 优化SQL;使用缓存 |
④ OutOfMemoryError
常见类型:
Java heap space:堆内存不足 → 增加-Xmx,检查内存泄漏Metaspace:元空间不足(JDK 8+) → 增加-XX:MaxMetaspaceSizeDirect buffer memory:堆外内存不足 → 限制Netty/Redis客户端DirectMemory
分析堆dump:
jhat -J-Xmx4g heap.hprof # 访问 http://localhost:7000
或使用Eclipse MAT工具可视化分析。
#!/bin/bash
# deploy-check.sh
echo "=== 部署后检查 ==="
# 检查服务状态
echo -n "1. 应用服务:"
curl -sf http://localhost:8080/actuator/health > /dev/null && echo "✅ 正常" || echo "❌ 异常"
# 检查数据库连接
echo -n "2. 数据库连接:"
nc -zv db.example.com 3306 2>&1 | grep -q "succeeded" && echo "✅ 连通" || echo "❌ 失败"
# 检查SSL证书
echo -n "3. SSL证书有效期:"
openssl s_client -connect www.example.com:443 /dev/null | \
openssl x509 -noout -dates | grep "notAfter"
# 检查磁盘空间
echo -n "4. 日志目录空间:"
df -h /var/log/app | awk 'NR==2 {print $5}' | grep -q "9[0-9]%" && echo "⚠️ 接近满" || echo "✅ 充足"
〔运维交接〕部署文档与知识沉淀
部署成功后,必须编写完整运维文档,确保团队可维护性。文档应包含:
- 环境拓扑图(服务器IP、端口、依赖关系)
- 部署命令与参数说明
- 配置项说明(重点参数含义)
- 故障处理SOP(标准操作流程)
- 升级回滚方案
- 联系人列表(开发、运维、DBA)
推荐使用Markdown格式,存储于GitLab/Wiki,版本化管理。文档示例:
## 项目部署文档 ### 1. 环境信息 - 生产服务器:10.0.1.10(主)、10.0.1.11(备) - 数据库:MySQL 8.0(10.0.2.20) - 缓存:Redis 7.0(10.0.2.21) ### 2. 部署步骤 1. 上传jar包:`scp app-1.0.0.jar root@10.0.1.10:/opt/app/` 2. 配置环境变量:`vi /etc/profile.d/app.sh` 3. 启动服务:`systemctl restart app` ### 3. 关键配置 - `spring.datasource.password`:通过环境变量注入 - JVM参数:`-Xms512m -Xmx1024m` ### 4. 故障处理 - 502错误:检查Nginx upstream与应用日志 - OOM:分析heapdump,增加内存
知识沉淀是技术团队成长的关键。建议定期组织部署复盘会,将问题转化为Checklist与自动化脚本,减少人为失误。
〔网友还关心〕常见问题汇总
① Linux下启动报权限拒绝
错误信息:
Error: Could not find or load main class com.example.Application Caused by: java.lang.ClassNotFoundException
实际原因为nohup.out无写权限。解决方案:
mkdir -p /var/log/app chown appuser:appuser /var/log/app nohup java -jar app.jar > /var/log/app/app.log 2>&1 &
② 端口被占用(8080)
解决方案:
- 修改应用端口:`java -jar app.jar --server.port=8081`
- 修改Nginx upstream为新端口
- 使用`lsof -i:8080`定位进程并终止
③ 控制台/日志中文乱码
添加JVM参数:
-Dfile.encoding=UTF-8
Logback配置:
<encoder>
<pattern>[%d{yyyy-MM-dd HH:mm:ss.SSS}] [%-5level] [%thread] [%logger{36}] - %msg%n</pattern>
<charset>UTF-8</charset>
</encoder>
④ 前端跨域(CORS)
Spring Boot全局配置:
@Configuration
public class WebConfig implements WebMvcConfigurer {
@Override
public void addCorsMappings(CorsRegistry registry) {
registry.addMapping("/api/**")
.allowedOrigins("https://www.example.com")
.allowedMethods("GET","POST","PUT","DELETE")
.allowCredentials(true);
}
}
Nginx配置:
add_header Access-Control-Allow-Origin https://www.example.com; add_header Access-Control-Allow-Methods 'GET, POST, OPTIONS'; add_header Access-Control-Allow-Headers 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range,Authorization'; add_header Access-Control-Allow-Credentials true;
〔结语〕持续优化与学习
java代码部署到服务器不仅是技术实践,更是工程思维的体现。从单机部署到云原生架构,从手动操作到CI/CD流水线,每一步演进都伴随着业务规模与团队成熟度的提升。
建议开发者:
- 定期回顾部署日志,提炼优化点
- 参与开源项目,学习优秀部署实践
- 掌握云平台(AWS ECS、阿里云ACK)部署方案
- 探索Service Mesh(Istio)与Serverless趋势
部署无小事,细节定成败。唯有扎实基础、持续实践,才能在复杂系统中游刃有余。
- 《Spring Boot实战》—— Spring Boot核心原理与部署
- 《Kubernetes权威指南》—— 云原生应用部署
- OWASP Top 10 —— 部署安全最佳实践
- 官方文档:Apache Tomcat / Spring Boot / Docker / Kubernetes