springboot配置ssl后启动一直是端口被占用如何解决

发布时间：2022-08-29 17:28:34 作者：iii
来源：亿速云阅读：262

Spring Boot 配置 SSL 后启动一直是端口被占用如何解决

在使用 Spring Boot 开发 Web 应用时，配置 SSL 是一个常见的需求。然而，有时在配置 SSL 后，启动应用时会遇到端口被占用的问题，导致应用无法正常启动。本文将详细探讨这个问题的原因，并提供几种解决方案。

1. 问题描述

在 Spring Boot 中配置 SSL 后，启动应用时可能会遇到以下错误信息：

***************************
APPLICATION FLED TO START
***************************

Description:

The Tomcat connector configured to listen on port 8080 failed to start. The port may already be in use or the connector may be misconfigured.

Action:

Verify the connector's configuration, identify and stop any process that's listening on port 8080, or configure this application to listen on another port.

这个错误提示表明，Spring Boot 应用尝试在端口 8080 上启动 Tomcat 服务器，但该端口已经被其他进程占用。

2. 问题原因

端口被占用的原因可能有以下几种：

其他应用占用了端口：可能是其他应用或服务已经占用了该端口。
Spring Boot 应用未正确关闭：可能是之前的 Spring Boot 应用未正确关闭，导致端口仍然被占用。
SSL 配置错误：可能是 SSL 配置错误，导致应用无法正确启动，进而导致端口被占用。

3. 解决方案

3.1 检查端口占用情况

首先，我们需要确认端口是否真的被占用。可以使用以下命令来检查端口占用情况：

Windows:
```
netstat -ano | findstr :8080
```
Linux/MacOS:
```
lsof -i :8080
```

如果端口被占用，命令会返回占用该端口的进程 ID (PID)。然后可以使用以下命令终止该进程：

Windows:
```
taskkill /PID <PID> /F
```
Linux/MacOS:
```
kill -9 <PID>
```

3.2 更改应用端口

如果端口确实被占用，并且无法终止占用端口的进程，可以考虑更改 Spring Boot 应用的端口。可以在 application.properties 或 application.yml 中配置新的端口：

application.properties:
```
server.port=8081
```
application.yml:
```
server:
port: 8081
```

3.3 检查 SSL 配置

如果端口没有被占用，但仍然无法启动应用，可能是 SSL 配置有问题。请检查 application.properties 或 application.yml 中的 SSL 配置是否正确：

application.properties:


server.ssl.enabled=true
server.ssl.key-store=classpath:keystore.jks
server.ssl.key-store-password=your_password
server.ssl.key-password=your_password

application.yml:


server:
ssl:
  enabled: true
  key-store: classpath:keystore.jks
  key-store-password: your_password
  key-password: your_password

确保 keystore.jks 文件存在，并且密码正确。

3.4 重启 IDE 或系统

有时，IDE 或系统可能会缓存旧的进程信息，导致端口被占用的假象。可以尝试重启 IDE 或系统，然后再次启动应用。

3.5 使用 `spring-boot-starter-web` 的 `undertow` 替代 `tomcat`

如果问题依然存在，可以考虑使用 undertow 作为 Web 服务器，替代默认的 tomcat。在 pom.xml 中添加以下依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-undertow</artifactId>
</dependency>

然后排除 tomcat 依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
        </exclusion>
    </exclusions>
</dependency>

4. 总结

在 Spring Boot 中配置 SSL 后，启动应用时遇到端口被占用的问题，通常可以通过检查端口占用情况、更改应用端口、检查 SSL 配置、重启 IDE 或系统、以及使用 undertow 替代 tomcat 等方法来解决。希望本文提供的解决方案能够帮助你顺利解决端口被占用的问题，确保应用能够正常启动。

如果你有其他问题或需要进一步的帮助，请随时在评论区留言。