Java Web 应用部署实战：从单机到分布式的三种方式

前言

一个 Web 应用从代码写完到真正能被用户访问，中间要经历"部署"这道坎。对于很多初学者来说，代码在本地能跑，但一到服务器上就各种问题。本文将从 Web 应用的基本原理讲起，完整覆盖 Java 应用部署的三种主流方式，并结合 Nginx 实现负载均衡的分布式模拟，帮助你建立完整的部署认知体系。

一、Web 应用是如何工作的？

每一个 HTTP 请求背后，都对应着一台主机上监听某个端口的进程。无论是 Java、Go、Python 还是 Node.js，本质上都是在某个端口上等待客户端连接，收到请求后执行业务逻辑，再返回响应。

理解了这一点，"部署"的本质就清晰了：把你的程序放到服务器上，让它稳定地监听端口、响应请求、执行业务逻辑。

二、为什么需要分布式？

当单台服务器无法承载越来越多的并发用户时，通常有两种扩容思路：

垂直扩展：换一台性能更强的机器，CPU 更多、内存更大。缺点是成本高，且有天花板。
水平扩展：加机器，让多个实例同时处理请求。这是更主流的方式------"能用加机器解决的问题都不是问题"。

水平扩展带来一个核心问题：如何保证数据的唯一性？ 答案是单一数据源------所有实例共享同一个数据库和缓存，业务逻辑层可以随意扩展，但数据层保持统一。

三、部署前要解决的问题

部署一个 Java 应用，不只是把代码搬上去那么简单，需要考虑以下几个方面：

1. 环境问题

实际项目通常有三套环境：

开发/测试环境：供开发者日常调试使用
预发布环境（预生产环境） ：上线前的最后验证
生产环境（正式环境） ：真实用户访问的环境

三套环境之间存在硬件、软件、数据库配置等差异，如何保证程序在不同环境下行为一致，是部署的核心挑战之一。

2. 依赖管理

一个 Java 应用的运行依赖包括：

自己编写的业务代码
引用的第三方库（Maven/Gradle 依赖）
特殊环境配置（数据库连接、缓存地址等）

3. 稳定性与可维护性

程序挂了如何自动恢复？
如何平滑升级和回滚版本？

带着这些问题，我们来看三种具体的部署方式。

四、实战：三种部署方式

本节模拟三个 Spring Boot 实例连接同一个 MySQL 和 Redis，通过 Nginx 做负载均衡转发，完整演示分布式部署场景。

准备工作：启动基础设施

首先用 Docker 启动 Redis 和 MySQL：

ini 复制代码

# 启动 Redis
docker run -p 6379:6379 -d redis

# 启动 MySQL 5.7
docker run -d -e MYSQL_ROOT_PASSWORD=root -p 3306:3306 mysql:5.7.27

连接 MySQL 后创建数据库并执行数据库迁移：

sql 复制代码

CREATE DATABASE `match`;

复制代码

mvn flyway:migrate

修改 application.properties，配置数据库驱动：

ini 复制代码

spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

验证启动后，访问 http://localhost:8080/ 能看到正常效果。

也可以在 /etc/hosts 中添加本地域名映射，方便后续测试：

bash 复制代码

sudo vi /etc/hosts
# 添加以下内容
127.0.0.1 abc.com

之后访问 http://abc.com:8080/ 同样有效。

方式一：Maven exec 插件直接运行

这是最简单的运行方式，适合本地开发调试。

在 pom.xml 中添加如下插件配置：

xml 复制代码

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>exec-maven-plugin</artifactId>
    <version>1.6.0</version>
    <configuration>
        <executable>java</executable>
        <arguments>
            <argument>-classpath</argument>
            <classpath/>
            <argument>xdml.Application</argument>
        </arguments>
    </configuration>
</plugin>

执行命令：

python 复制代码

mvn compile exec:exec

Maven 会自动将所有传递性依赖加入 classpath，无需手动管理 jar。

优点： 配置简单，适合开发阶段快速验证。

缺点： 依赖本地 Maven 环境，不适合自动化部署场景。

方式二：打成可执行 Jar 包运行

Jar 包是 Java 编译产物的打包格式。一个可直接运行的 Jar 包需要在 MANIFEST.MF 中声明主类（Spring Boot Maven 插件会自动处理这一步）。

打包：

go 复制代码

mvn clean package -DskipTests

运行（可通过参数指定端口，模拟多实例）：

ini 复制代码

# 方式一：通过 --server.port 参数
java -jar ./target/demo-0.0.1.jar --server.port=8081

# 方式二：通过 -D 系统参数
java -Dserver.port=8081 -jar ./target/demo-0.0.1.jar

优点： 简单可靠，一个文件包含所有代码和依赖，方便传输和部署。

缺点： 运行环境依赖目标机器已安装对应版本的 JVM。若服务器 JDK 版本与开发环境不一致，可能出现兼容性问题。

方式三：Docker 容器化部署

Docker 是目前最主流的部署方式。它将操作系统、JVM、应用代码等所有依赖打包成一个镜像，做到完全的环境隔离，实现"一次构建，到处运行"。

核心优势：

彻底解决环境兼容性问题
轻量级，启动迅速
天然支持大规模水平扩展

编写 Dockerfile：

bash 复制代码

# 基础镜像（JRE 8，按需修改版本）
FROM eclipse-temurin:8-jre

# 设置工作目录
WORKDIR /app

# 将打好的 jar 包复制到镜像中
COPY target/demo-0.0.1.jar app.jar

# 定义容器启动命令
ENTRYPOINT ["java", "-jar", "app.jar"]

构建镜像：

perl 复制代码

mvn clean package -DskipTests
docker build -t my-app .

运行容器（映射到不同端口模拟多实例）：

arduino 复制代码

docker run -p 8082:8080 my-app

处理外部化配置： 容器内默认没有数据库地址等配置，需要挂载外部配置文件：

bash 复制代码

docker run \
  -v `pwd`/application.properties:/app/application.properties \
  -p 8082:8080 \
  my-app

注意： 容器内部默认无法解析宿主机的域名（如 abc.com），数据库和 Redis 的连接地址需使用宿主机 IP 而非 localhost，否则会出现连接失败的问题。

五、使用 Nginx 做负载均衡

三种方式部署的三个实例都在运行后，需要一个统一的入口将流量分发给它们，这就是 Nginx 负载均衡的作用。

Nginx 监听 80 端口，稳定性极高，即便后端服务崩溃，Nginx 本身也能在极短时间内重启恢复。

使用 Docker 启动 Nginx：

bash 复制代码

docker run \
  --restart=always \
  -v `pwd`/nginx.conf:/etc/nginx/nginx.conf:ro \
  -p 80:80 \
  -d nginx

nginx.conf 负载均衡配置：

ini 复制代码

events {
    worker_connections 1024;
}

http {
    # 定义后端服务集群（负载均衡池）
    upstream app_servers {
        server 192.168.1.100:8080;  # 实例1
        server 192.168.1.101:8080;  # 实例2
        server 192.168.1.102:8080;  # 实例3

        # 本地多端口模拟时写法：
        # server host.docker.internal:8080;
        # server host.docker.internal:8081;
        # server host.docker.internal:8082;
    }

    server {
        listen 80;

        location / {
            proxy_pass http://app_servers;

            # 必要的转发请求头
            proxy_set_header Host              $host;
            proxy_set_header X-Real-IP         $remote_addr;
            proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
        }
    }
}

常见问题： 出现 502 Bad Gateway 错误，通常是因为 Nginx 容器内无法访问后端地址。在 Docker 环境中，容器间通信不能使用 localhost，需要使用宿主机 IP 或 host.docker.internal（Mac/Windows Docker Desktop 支持）。

六、三种方式对比总结

方式	适用场景	优点	缺点
Maven exec 插件	本地开发调试	简单快速	不适合自动化部署
可执行 Jar 包	传统服务器部署	简单可靠，无额外工具依赖	依赖目标机器 JVM 版本
Docker 容器	现代化生产部署	环境隔离，易扩展，可移植	需要了解 Docker 基础知识

七、总结

本文从 Web 应用的工作原理出发，逐步引出分布式部署的核心诉求，并通过三种方式完整演示了 Java 应用的部署过程：

Maven exec：最轻量，适合开发阶段；
Jar 包部署：传统且可靠，适合对环境有把握的场景；
Docker 容器：现代主流，彻底解决环境依赖问题，是生产环境的首选。

结合 Nginx 的负载均衡，三个实例共享同一套 MySQL 和 Redis，真实模拟了水平扩展的分布式架构。理解这套体系，是迈向工程化开发的重要一步。