这种时好时坏的离线连接问题确实挺挠头的，我之前也碰到过类似情况，大概率是这几个原因在搞鬼：

1. localhost的DNS解析缓存问题 #

很多人默认localhost直接对应127.0.0.1，但部分系统或网络配置下，联网时系统会通过外部DNS解析localhost（正常情况本地hosts文件应该优先处理，但如果配置异常就会走外部DNS），并把解析结果缓存下来。离线时如果缓存过期，系统会再次尝试去外部DNS查找localhost，自然找不到导致连接失败；而联网成功连接一次后，缓存被刷新，离线时就能正常使用一段时间，直到缓存失效。

解决办法：

• 直接在Node.js的连接配置里用127.0.0.1代替localhost，彻底绕开DNS解析环节：

  const connection = mysql.createConnection({
    host: '127.0.0.1', // 替换localhost
    user: 'your_user',
    password: 'your_password',
    database: 'your_db'
  });
  

• 检查本地hosts文件（Windows路径：C:\Windows\System32\drivers\etc\hosts；Linux/macOS路径：/etc/hosts），确保存在且未被注释的以下内容：

  127.0.0.1       localhost
  ::1             localhost
  

2. MySQL的绑定地址配置限制 #

如果你的MySQL配置文件（XAMPP中一般是my.cnf或my.ini，位于XAMPP的mysql目录下）里，bind-address被设置成了外部IP或动态获取的公网IP，而非127.0.0.1或0.0.0.0，那离线时这个外部IP不可用，Node.js就无法连接；但phpMyAdmin大概率是通过本地socket连接的（XAMPP默认会配置socket路径），所以不受网络状态影响，能正常访问。

解决办法：

• 打开MySQL配置文件，找到bind-address项，修改为：

  bind-address = 127.0.0.1
  

  如果需要允许外部设备连接，可设为0.0.0.0，修改后重启XAMPP中的MySQL服务生效。

3. Node.js MySQL模块的连接方式差异 #

Node.js的mysql模块处理localhost时，不同系统的行为有差异：部分场景下会优先尝试Unix socket（Linux/macOS）或Named Pipe（Windows），如果找不到指定的socket路径，才会 fallback到TCP连接。如果socket配置异常，模块就会走TCP连接，这时候就需要解析localhost，离线时解析失败就会连不上；而联网时解析成功后，模块可能缓存了连接状态，所以离线时还能撑一段时间。

解决办法：

• 显式指定socket路径（XAMPP的MySQL socket路径：Windows一般是\\.\pipe\MySQL；Linux/macOS通常是/opt/lampp/var/mysql/mysql.sock），直接用socket连接绕开网络解析：

  const connection = mysql.createConnection({
    user: 'your_user',
    password: 'your_password',
    database: 'your_db',
    socketPath: '/opt/lampp/var/mysql/mysql.sock' // 根据你的系统替换路径
  });
  

4. 系统网络缓存/路由表的临时异常 #

少数情况下，联网时系统会自动添加本地回路的路由规则，离线时部分路由规则被清理，导致Node.js无法通过TCP连接到本地MySQL。这种情况比较少见，但可以通过刷新网络缓存验证。

解决办法：

• Windows：打开命令提示符，依次执行ipconfig /flushdns和netsh winsock reset，然后重启Node.js进程
• Linux/macOS：执行sudo dscacheutil -flushcache（macOS）或sudo systemd-resolve --flush-caches（Linux），再重启Node.js进程

总结一下，最常见的解决方式就是用127.0.0.1代替localhost，或者直接指定socket路径连接，这两个方法基本能解决90%以上的这类问题。

内容的提问来源于stack exchange，提问作者Doomer