Node.js连接Linux数据库失败，socket与TCP模式解析

在使用Node.js开发应用并与Linux服务器上的MySQL数据库交互时，开发者经常会遇到连接失败的问题。即使密码正确、服务运行正常，仍然可能因为连接模式的选择不当而导致连接异常。本文将通过一个具体案例，深入分析Node.js连接Linux数据库失败的原因，并提供解决方案。

问题背景

某开发者在部署Node.js应用时，发现尽管MySQL服务正在运行，且提供的登录凭据（用户名root，空密码）完全正确，但Node.js始终无法成功连接数据库。经过反复排查，确认MySQL服务状态正常，命令行下可以直接通过mysql -uroot登录，但Node.js代码却报错提示Access denied。

核心原因分析

根据对Node.js mysql2模块的行为研究，Linux环境下该模块存在一个默认行为：当连接参数中指定host: 'localhost'时，mysql2会优先尝试使用Unix socket进行连接，而完全忽略端口号设置。这意味着即使指定了端口3380，该端口也不会生效，因为socket连接不依赖于端口号。

这种设计虽然在某些场景下可以提高性能，但在实际开发中容易导致混淆。特别是对于使用空密码登录的root用户，mysql2模块对socket模式下的空密码支持存在兼容性问题，经常抛出ER_ACCESS_DENIED_NO_PASSWORD_ERROR错误。

解决方案对比

针对上述问题，有两种可行的解决方案，开发者可以根据实际需求选择其一：

使用Unix socket模式

这种方式适用于本机环境，但不适合远程访问，且在环境迁移时容易出现问题。

使用TCP模式

推荐采用TCP模式进行连接，这种方式更稳定且适合生产环境。关键在于将host参数改为127.0.0.1，这样可以强制使用TCP协议，并确保端口号生效：

注意：使用TCP模式前，需要确保数据库用户已经通过ALTER USER命令修改为mysql_native_password认证方式。

实际验证过程

为了验证上述分析，开发者进行了以下测试步骤：

首先检查MySQL服务状态，确认服务已启动并正常运行：

图1显示MySQL服务处于活动状态，表明服务本身没有问题。

接着测试Node.js代码，分别尝试socket模式和TCP模式的连接配置。在TCP模式下，成功建立了连接并执行了数据库操作。

最后通过网络工具验证端口监听情况，确认3380端口已被MySQL服务占用：

通过以上分析和测试，可以得出以下结论：

在Linux环境下，Node.js mysql2模块默认优先使用Unix socket连接，这可能导致端口号被忽略。
对于root用户，socket模式下的空密码支持可能存在兼容性问题，容易引发Access denied错误。
推荐使用TCP模式进行连接，特别是在生产环境中，这种方式更加稳定可靠。
使用TCP模式时，需要注意数据库用户的认证方式，必要时进行调整以匹配tcp协议的要求。

开发者应根据实际应用场景选择合适的连接模式，并注意配置细节，以避免类似连接失败的问题发生。对于需要高可用性的系统，建议采用TCP模式并做好相应的安全配置。