java代码部署到服务器

权威部署指南|实战经验总结|覆盖多平台、多环境部署方案

〔部署全景〕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 11
JDK 17
JDK 21

〔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+(最后维护版)。

💡 部署建议:生产环境优先选择Adoptium Temurin或Amazon Corretto,避免Oracle JDK商业授权风险。使用java -version验证实际运行版本,确保与编译版本一致。

〔Tomcat部署〕传统Web应用部署方案

尽管容器化成为趋势,Tomcat仍广泛用于中小型企业Web应用。其轻量、配置灵活,适合传统JSP/Servlet应用迁移。

① 安装Tomcat

以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
② 优化server.xml

编辑/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"
④ systemd服务管理

创建/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
传统war
Docker部署

① 可执行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
⚙️ Spring Boot关键配置

生产环境推荐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可快速搭建多容器应用。

① 安装Docker

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编排

创建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)提供容器编排、自动扩缩容、服务发现等能力,适合中大型微服务集群。

基础部署
Helm Chart

① 基础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
💡 进阶建议:使用Ingress暴露服务(需安装Ingress Controller如Nginx Ingress),配置TLS证书(通过Cert-Manager自动申请Let's Encrypt证书),实现HTTPS访问。

〔Nginx反向代理〕生产级流量入口

Nginx作为高性能HTTP服务器与反向代理,是Java应用生产环境必备组件,用于负载均衡、静态资源处理、SSL终止。

① 安装Nginx

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
② 手动配置HTTPS

/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)

〔故障排查〕典型问题与解决方案

部署后常见问题及定位方法:

500错误
502 Bad Gateway
性能慢
OOM问题

① HTTP 500内部服务器错误

排查步骤:

  1. 检查应用日志(tail -f /var/log/app/app.log)
  2. 确认Spring Boot配置(application-prod.yml)
  3. 验证数据库连接(telnet db.example.com 3306)
  4. 检查权限(/var/log/app目录写权限)

常见原因:

  • 配置文件缺失/路径错误
  • 数据库密码错误(环境变量未传递)
  • 数据库驱动缺失(如MySQL 8需mysql-connector-java 8.0+)
  • JVM参数冲突(如-Xmx超过物理内存)

② 502 Bad Gateway(Nginx)

排查步骤:

  1. 测试后端服务是否存活(curl http://127.0.0.1:8080/actuator/health)
  2. 检查Nginx upstream配置(IP/端口是否正确)
  3. 调整代理超时(proxy_read_timeout)
  4. 查看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:MaxMetaspaceSize
  • Direct 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权限问题
端口冲突
中文乱码
跨域问题

① 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