java

关注公众号 jb51net

关闭
首页 > 软件编程 > java > java.net.ConnectException报错解决

java.net.ConnectException: Connection refused报错的解决方法详解

作者：李少兄

这篇文章主要为大家详细介绍了Java开发中常见的java.net.ConnectException(连接被拒绝)异常,从操作系统层面解析其本质,详细分析了常见原因和解决方法,希望对大家有所帮助

前言：一个高频却常被误解的异常

在 Java 企业级应用开发中，无论是构建 Web 后端服务、微服务架构，还是进行数据集成与批处理任务，开发者几乎不可避免地会遇到如下异常堆栈：

java.net.ConnectException: Connection refused: connect
    at java.base/sun.nio.ch.Net.connect0(Native Method)
    at java.base/sun.nio.ch.Net.connect(Net.java:589)
    at java.base/sun.nio.ch.Net.connect(Net.java:578)
    at java.base/sun.nio.ch.NioSocketImpl.connect(NioSocketImpl.java:583)
    at java.base/java.net.SocksSocketImpl.connect(SocksSocketImpl.java:327)
    at java.base/java.net.Socket.connect(Socket.java:751)
    ...

该异常通常出现在尝试建立 TCP 连接时——例如通过 JDBC 连接 MySQL、调用 RESTful API、连接 Redis 缓存、或与消息队列（如 RabbitMQ、Kafka）通信。尽管其字面意思看似直白（“连接被拒绝”），但许多开发者在初次遭遇时仍会陷入困惑：是代码写错了？是网络不通？还是服务宕机了？

一、问题本质：操作系统层面的“拒绝”信号

1.1 异常来源并非 Java 虚拟机

首先必须明确：java.net.ConnectException 是 Java 对底层操作系统返回错误码的封装。当 Java 应用调用 Socket.connect() 方法时，JVM 会委托操作系统内核发起 TCP 连接请求。若内核在尝试建立连接过程中收到特定的网络响应（如 RST 包），便会向 JVM 返回一个错误码（在 Linux/Unix 系统中为 ECONNREFUSED，在 Windows 中为 WSAECONNREFUSED），JVM 再将其转换为 ConnectException 抛出。

因此，该异常反映的是网络层或传输层的问题，而非应用逻辑错误。

1.2 TCP 三次握手中的“拒绝”机制

理解此异常的关键在于掌握 TCP 协议的行为：

核心结论：Connection refused = 目标主机可达 + 目标端口无服务监听

这与 Connection timed out（连接超时）有本质区别：

二、根本原因分类与排查指南

根据多年工程实践经验，导致 Connection refused 的原因可归纳为以下五大类。

2.1 服务进程未启动（最常见原因）

这是本地开发、测试环境中占比最高的原因。服务未运行，自然无法监听端口。

Windows 系统操作指南

在 Windows 操作系统中，MySQL、PostgreSQL、Redis 等数据库服务通常以“Windows 服务”的形式安装和管理。如果服务未启动，则对应的端口（如 MySQL 默认 3306）将不会被监听，从而导致 Connection refused 错误。

图形化界面操作步骤（推荐初学者使用）

  1. 打开“服务”管理控制台：

    • 按下键盘上的 Win + R 组合键，弹出“运行”对话框。
    • 在输入框中键入 services.msc，然后按回车键或点击“确定”。
    • 此时将打开“服务”窗口，其中列出了当前系统中所有已注册的服务。

  2. 查找目标数据库服务：

    • 在服务列表中，滚动查找名称包含 MySQL 的条目。
    • 常见的服务名称包括：
      • MySQL80（MySQL 8.0 版本）
      • MySQL57（MySQL 5.7 版本）
      • MySQL（通用名称，多见于旧版安装）
      • MariaDB（MariaDB 数据库）
      • Redis（Redis 服务）
    • 如果你不确定具体名称，可以右键点击任意服务 → “属性”，查看“路径到可执行文件”字段，确认是否为你安装的数据库程序。

  3. 检查服务状态并启动：

    • 查看“状态”列。如果该列为空白，说明服务当前未运行。
    • 右键点击该服务名称，在弹出的上下文菜单中选择“启动”。
    • 启动成功后，“状态”列将显示为“正在运行”。
    • 如果启动失败（例如提示“错误 1067：进程意外终止”），则需进一步检查数据库的日志文件（通常位于 C:\ProgramData\MySQL\MySQL Server X.X\Data\ 目录下的 .err 文件）。

  4. 设置开机自动启动（可选）：

    • 为避免每次重启电脑后手动启动服务，可右键点击服务 → “属性”。
    • 在“启动类型”下拉菜单中选择“自动”。
    • 点击“应用”并“确定”。下次系统启动时，该服务将自动运行。

命令行方式（适用于脚本化或高级用户）

Windows 提供了强大的命令行工具来管理服务，无需依赖图形界面。

1.列出所有与 MySQL 相关的服务：

sc queryex type= service state= all | findstr /i "mysql"

2.启动指定服务：

net start MySQL80

3.停止服务：

net stop MySQL80

4.查询服务详细信息：

sc qc MySQL80

此命令可查看服务的可执行文件路径、依赖关系、启动账户等关键信息，对排错非常有帮助。

macOS 系统操作指南

macOS 上的数据库服务管理方式取决于其安装途径。主流方式有两种：Homebrew（开发者首选）和 官方 .dmg 安装包。

A. 通过 Homebrew 安装的 MySQL（强烈推荐）

Homebrew 是 macOS 上最流行的包管理器，它能自动处理依赖、配置和后台服务管理。

检查 Homebrew 服务状态：打开“终端”（Terminal），输入以下命令：

brew services list

该命令会列出所有由 Homebrew 管理的后台服务。

输出示例：

Name    Status  User     Plist
mysql   stopped          /Users/yourname/Library/LaunchAgents/homebrew.mxcl.mysql.plist
redis   started yourname /Users/yourname/Library/LaunchAgents/homebrew.mxcl.redis.plist

Status 列显示 stopped 表示服务未运行。

启动 MySQL 服务：

# 启动服务，并设置为登录时自动启动（仅对当前用户）
brew services start mysql
# 或者，仅启动一次（不设为自动启动）
brew services run mysql

start 命令会创建一个 launchd 配置文件（.plist），确保服务在用户登录时自动启动。

run 命令则只在当前终端会话中运行服务，关闭终端后服务也会停止。

停止服务：

brew services stop mysql

验证服务是否正常运行：

# 检查 MySQL 进程
ps aux | grep mysqld
# 尝试连接数据库（默认 root 用户无密码，首次安装后建议运行 mysql_secure_installation）
mysql -u root

查看日志（排错必备）：Homebrew 安装的 MySQL 日志通常位于：

cat /opt/homebrew/var/mysql/$(hostname).err
# 或 Intel Mac:
cat /usr/local/var/mysql/$(hostname).err

B. 通过官方 .dmg 安装包安装的 MySQL

这种方式会将 MySQL 安装到 /usr/local/mysql/ 目录，并提供一个系统偏好设置面板。

图形化启动方式：

命令行启动/停止：官方安装包提供了便捷的脚本：

# 启动 MySQL
sudo /usr/local/mysql/support-files/mysql.server start
# 停止 MySQL
sudo /usr/local/mysql/support-files/mysql.server stop
# 重启 MySQL
sudo /usr/local/mysql/support-files/mysql.server restart
# 检查状态
sudo /usr/local/mysql/support-files/mysql.server status

添加 PATH（方便使用 mysql 命令）：为了能在任意目录下直接使用 mysql 命令，需要将 MySQL 的 bin 目录加入环境变量。

编辑你的 shell 配置文件（如 ~/.zshrc 或 ~/.bash_profile）：

echo 'export PATH="/usr/local/mysql/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

之后即可直接在终端输入 mysql -u root -p 进行连接。

Linux 系统操作指南

Linux 发行版众多，但现代主流发行版（如 Ubuntu 16.04+、CentOS 7+、Debian 8+）均采用 systemd 作为初始化系统和服务管理器。旧版系统（如 CentOS 6）则使用 SysV init。

A. 使用 systemd（现代 Linux 发行版标准）

systemd 通过 systemctl 命令统一管理所有系统服务。

检查 MySQL 服务状态：不同发行版对 MySQL 服务的命名略有差异：

执行以下命令之一：

# Ubuntu/Debian
sudo systemctl status mysql
# CentOS/RHEL
sudo systemctl status mysqld

Ubuntu/Debian 系：服务名为 mysql

CentOS/RHEL/Fedora 系：服务名为 mysqld

关键观察点：

启动、停止、重启服务：

# 启动服务
sudo systemctl start mysql        # 或 mysqld
# 停止服务
sudo systemctl stop mysql
# 重启服务（修改配置后常用）
sudo systemctl restart mysql
# 重新加载配置（不中断服务）
sudo systemctl reload mysql

设置开机自启：

# 启用开机自启
sudo systemctl enable mysql
# 禁用开机自启
sudo systemctl disable mysql

enable 命令会在 /etc/systemd/system/multi-user.target.wants/ 目录下创建一个符号链接。

查看实时服务日志（排错神器）：systemd 集成了日志系统 journald，可通过以下命令实时跟踪服务日志：

# 实时跟踪 MySQL 服务日志
sudo journalctl -u mysql -f
# 查看最近 100 行日志
sudo journalctl -u mysql -n 100

这比直接查看 /var/log/mysql/error.log 更方便，因为它包含了 systemd 的元数据（如时间戳、进程ID）。

B. 使用 SysV init（旧版 Linux 系统）

虽然已逐渐被淘汰，但在一些遗留系统中仍会遇到。

检查服务状态：

sudo service mysql status
# 或直接调用 init 脚本
sudo /etc/init.d/mysql status

管理服务：

# 启动
sudo service mysql start
# 停止
sudo service mysql stop
# 重启
sudo service mysql restart

设置开机自启：

# Ubuntu/Debian (使用 update-rc.d)
sudo update-rc.d mysql defaults
# CentOS 6 (使用 chkconfig)
sudo chkconfig --level 35 mysql on

2.2 客户端连接配置错误

连接字符串（URL）中的 IP 地址、端口号或协议写错。

常见错误示例：

排查重点：

2.3 服务绑定地址限制（Bind Address Issue）

服务虽已启动，但仅绑定到 127.0.0.1（loopback 接口），拒绝来自外部 IP 的连接。

典型表现：

验证命令（在服务所在主机执行）：

ss -tuln | grep :3306
# 或
netstat -tuln | grep :3306

输出示例：

解决方案：

2.4 防火墙或安全组策略拦截

虽然服务在监听，但网络中间设备阻止了连接请求。

本地防火墙：

Windows：检查“Windows Defender 防火墙” -> “高级设置” -> “入站规则”，确保有允许目标端口（如 3306）的规则。

Linux (UFW)：

sudo ufw status verbose
sudo ufw allow 3306/tcp

Linux (firewalld)：

sudo firewall-cmd --list-ports
sudo firewall-cmd --permanent --add-port=3306/tcp
sudo firewall-cmd --reload

云平台安全组（极易被忽视！）：

2.5 容器化环境网络配置问题

在 Docker、Kubernetes 等容器平台中，网络命名空间隔离增加了复杂性。

Docker 常见问题：

Kubernetes 问题：

排查命令：

docker ps                          # 查看运行容器
docker port <container_id>         # 检查端口映射
kubectl get svc,pods -n <namespace> # 查看 K8s 服务状态

三、标准化排查流程（推荐顺序）

遵循 “由近及远、由内到外、先服务后网络” 的原则，逐步缩小问题范围。

步骤 1：确认目标服务是否真正运行并监听端口

操作位置：服务所在主机

# 检查进程
ps aux | grep <service_name>
# 检查端口监听（关键！）
ss -tuln | grep :<PORT>
# 或
netstat -tuln | grep :<PORT>

步骤 2：核对客户端连接配置

操作位置：客户端代码/配置文件

步骤 3：使用telnet或nc测试 TCP 连通性

操作位置：客户端主机

telnet <IP> <PORT>
# 或
nc -vz <IP> <PORT>

提示：Windows 可启用 Telnet 客户端功能，或使用 PowerShell 命令：

Test-NetConnection -ComputerName 127.0.0.1 -Port 3306

步骤 4：检查防火墙与云安全组

操作位置：服务所在主机 + 云控制台

步骤 5：容器环境专项检查

操作位置：Docker Host / Kubernetes Cluster

四、预防措施与工程最佳实践

4.1 自动化依赖管理

使用 docker-compose.yml 统一管理本地开发依赖（MySQL、Redis、Elasticsearch 等），避免手动启停遗漏。

version: '3'
services:
  mysql:
    image: mysql:8.0
    ports:
      - "3306:3306"
    environment:
      MYSQL_ROOT_PASSWORD: root

4.2 健康检查与启动探针

在应用启动时加入数据库连接探针，失败时提供友好提示：

@PostConstruct
public void checkDatabaseConnection() {
    try (Connection conn = dataSource.getConnection()) {
        // 成功
    } catch (SQLException e) {
        log.error("无法连接数据库，请检查服务是否启动及配置是否正确", e);
        System.exit(1); // 或抛出自定义异常
    }
}

4.3 配置分离与环境隔离

4.4 日志增强与可观测性

在捕获 ConnectException 时，记录完整的连接目标（脱敏后）：

log.error("连接 {} 失败", maskUrl(url), e);

集成 APM 工具（如 SkyWalking、Prometheus）监控服务依赖健康状态。

4.5 基础设施即代码（IaC）

使用 Terraform、Ansible 管理云资源与安全组，确保网络策略可版本化、可审计。

以上就是java.net.ConnectException: Connection refused报错的解决方法详解的详细内容，更多关于java.net.ConnectException报错解决的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:
阅读全文