SpringBoot与WSL2中MySQL集成重启连接失败问题求助

针对你遇到的WSL2 Ubuntu 20.04环境中SpringBoot首次启动能正常连接本地MySQL、重启应用却连接失败的问题，结合你的排查情况（Workbench可连接、Docker MySQL无异常），可以从以下几个方向解决：

1. 修正MySQL的监听绑定配置 #

WSL2采用NAT网络模式，localhost在WSL和Windows环境指向不同地址，若MySQL仅绑定localhost，重启应用时可能出现网络访问失效：

• 编辑MySQL配置文件：sudo nano /etc/mysql/mysql.conf.d/mysqld.cnf
• 找到bind-address项，将其修改为0.0.0.0（允许所有IP段访问），或者直接注释掉该行
• 重启MySQL服务生效：sudo systemctl restart mysql

2. 配置SpringBoot连接池的失效检测 #

默认连接池可能缓存了失效的TCP连接，重启应用时未主动校验连接有效性：
在application.properties中添加HikariCP（SpringBoot默认连接池）的校验配置：

# 连接最大生命周期，避免长期占用无效连接
spring.datasource.hikari.max-lifetime=1800000
# 连接空闲超时时间，自动回收闲置连接
spring.datasource.hikari.idle-timeout=600000
# 每次获取连接前执行校验查询
spring.datasource.hikari.connection-test-query=SELECT 1
# 校验超时时间
spring.datasource.hikari.validation-timeout=3000

3. 更换数据库连接URL的IP地址 #

避免使用localhost，改用Windows主机的IP（WSL中可通过cat /etc/resolv.conf | grep nameserver | awk '{print $2}'获取）或WSL2自身的虚拟IP（hostname -I查看），例如：

spring.datasource.url=jdbc:mysql://192.168.x.x:3306/your_db?useSSL=false&serverTimezone=UTC

4. 重置WSL2网络映射（临时应急方案） #

若上述配置无效，可通过重置WSL网络快速恢复：
在Windows命令提示符中执行：

wsl --shutdown
netsh winsock reset
ipconfig /flushdns

重启WSL后再启动SpringBoot应用验证。

内容的提问来源于stack exchange，提问作者rpin-01