如何在 Spring Boot 中指定端口

Spring Boot 是一种简化 Java EE 应用开发的框架,它使得开发和部署变得更加方便。而在实际开发过程中,可能需要更改 Spring Boot 应用的运行端口。本文将系统地介绍如何在 Spring Boot 中指定端口,适合刚入行的新手。

整体流程

首先,我们来看一下指定端口的整体流程:

步骤 说明
1 创建 Spring Boot 项目
2 打开 application.properties 文件
3 添加或修改服务器端口配置
4 启动 Spring Boot 应用
5 验证指定端口是否生效

接下来,我们逐步详细阐述每一个步骤。

步骤详解

1. 创建 Spring Boot 项目

在开始之前,确保您已经安装了 Java 和 Spring Boot。您可以使用 Spring Initializr([

选择以下参数来创建项目:

  • Project: Maven Project
  • Language: Java
  • Spring Boot: 选择稳定版本(例如 2.6.7)
  • 项目元数据:填入 Group 和 Artifact 等
  • Dependencies: 添加 Web 依赖,确保包括 Spring Web

下载项目并将其解压到您的工作目录中。

2. 打开 application.properties 文件

在项目的资源文件夹 src/main/resources 中,找到 application.properties 文件。这个文件是 Spring Boot 的配置文件,您可以在这里配置很多参数。

3. 添加或修改服务器端口配置

application.properties 中添加以下代码:

# 设置服务器端口为8081
server.port=8081

注释

  • server.port 是 Spring Boot 提供的用于设置服务器端口的属性。这里我们将端口设置为 8081,您可以根据需要替换成其他端口。

4. 启动 Spring Boot 应用

打开终端,导航到项目的根目录,然后使用 Maven 启动您的 Spring Boot 应用:

./mvnw spring-boot:run

如果您使用的是 Windows 操作系统,请使用以下命令:

mvnw.cmd spring-boot:run

5. 验证指定端口是否生效

启动成功后,您将在控制台看到类似以下的输出:

Tomcat started on port(s): 8081 (http) with context path ''

这表明您的 Spring Boot 应用正在 8081 端口运行。接下来,打开浏览器并访问 http://localhost:8081,您应该能看到默认的欢迎页面。

整体流程示意图

以下是整个流程的序列图,展示了从创建项目到验证端口的过程:

sequenceDiagram
    participant User
    participant SpringBoot
    User->>SpringBoot: 创建 Spring Boot 项目
    User->>SpringBoot: 打开 application.properties
    User->>SpringBoot: 修改 server.port=8081
    User->>SpringBoot: 启动应用
    SpringBoot->>User: 应用启动成功,监听8081端口
    User->>User: 在浏览器访问 http://localhost:8081

常见问题

  1. 如何选择端口?
    需要确保所选择的端口没有被其他服务占用。通常,端口号范围在 1024 到 49151 是为用户注册的端口。

  2. 如何在代码中动态改变端口?
    您也可以通过 Java 代码来设置端口。在 main 方法中,您可以使用以下代码:

    @SpringBootApplication
    public class MyApplication {
        public static void main(String[] args) {
            SpringApplication app = new SpringApplication(MyApplication.class);
            app.setDefaultProperties(Collections.singletonMap("server.port", "8082"));
            app.run(args);
        }
    }
    

    注释

    • 这里我们通过 setDefaultProperties 方法来动态设置服务器端口为 8082。
  3. 如何在开发环境和生产环境中使用不同的端口?
    您可以创建不同的 application-{profile}.properties 文件,例如 application-dev.propertiesapplication-prod.properties,并在其中配置不同的端口号。

结尾

通过以上步骤,您可以很轻松地在 Spring Boot 中指定服务器端口。无论是在开发还是生产环境,合理地配置端口都是非常重要的,它有助于避免端口冲突并提供更好的可管理性。希望这篇文章能够帮助到刚入行的小白开发者,祝您编程愉快!