Node.js+MySQL2连接ETIMEDOUT及Railway部署崩溃问题求助

一、本地运行connect ETIMEDOUT错误解决 #

原因 #

Railway的MySQL数据库默认仅允许内部网络访问，本地直接连接会被防火墙拦截；同时代码未指定Railway数据库的非默认端口，且硬编码了数据库凭证、未处理连接错误。

解决步骤 #

• 开启Railway数据库公网访问
  登录Railway控制台进入你的数据库服务，在Settings页面找到Public Network Access并切换为Enabled，复制更新后的连接信息，重点记录非3306的端口号。

• 改用环境变量管理数据库凭证

  1. 在项目根目录创建.env文件，填入Railway提供的实际值：

     DB_HOST=containers-us-west-174.railway.app
     DB_USER=user
     DB_PASSWORD=password
     DB_NAME=railway
     DB_PORT=你的铁路数据库端口
     

  2. 修改db.js，从环境变量读取配置并主动处理连接：

     import mysql2 from 'mysql2';
         
     export const db = mysql2.createConnection({
         host: process.env.DB_HOST,
         user: process.env.DB_USER,
         password: process.env.DB_PASSWORD,
         database: process.env.DB_NAME,
         port: process.env.DB_PORT
     })
     
     // 主动连接并处理错误
     db.connect((err) => {
       if (err) {
         console.error('数据库连接失败:', err);
         return;
       }
       console.log('数据库连接成功');
     });
     

• 确保环境变量生效
  确认dotenv已安装，且index.js中dotenv.config()调用在数据库连接逻辑之前。

二、Railway部署bcrypt_lib.node: invalid ELF header错误解决 #

原因 #

bcrypt是原生C++模块，本地Windows环境编译的二进制文件与Railway的Linux服务器环境不兼容，导致加载失败。

解决步骤 #

方案1：替换为纯JS实现的bcryptjs（推荐）

• 卸载原bcrypt：

  npm uninstall bcrypt
  

• 安装bcryptjs：

  npm install bcryptjs
  

• 修改所有使用bcrypt的代码，将导入语句改为：

  import bcrypt from 'bcryptjs';
  

  注：bcryptjs的API与bcrypt完全一致，无需修改其他逻辑

方案2：避免提交本地node_modules

• 在.gitignore文件中添加：

  node_modules/
  .env
  

• 删除本地node_modules目录，重新提交代码到仓库
• Railway部署时会自动在Linux环境下重新安装依赖，编译适配的bcrypt二进制文件

额外注意事项 #

index.js中multer的存储路径../client/public/upload在Railway部署时会失效，建议改为项目内相对路径并确保目录存在：

import fs from 'fs';
const uploadDir = './uploads';
if (!fs.existsSync(uploadDir)) {
  fs.mkdirSync(uploadDir, { recursive: true });
}

const storage = multer.diskStorage({
    destination: uploadDir,
    filename: function (req, file, cb) {
        cb(null, Date.now() + '-' + file.originalname);
    }
})

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