Express+Next.js项目前端数据库连接失败，服务器连接正常求助

架构老林

2026-7-14

问题排查与解决方案

根据你描述的现象（服务器启动时能正常连接数据库，但前端调用注册接口时出现空用户、无密码的权限错误），以下是针对性的排查方向和解决方法：

1. 确认请求是否真的发到了Express服务器

如果你的Next.js前端和Express服务器在同一项目中，很可能出现请求路径冲突：前端误将注册请求发到了Next.js自身的pages/api/register路由（而非Express的/api/register）。若该Next.js API路由未正确加载.env变量，就会用空凭据连接数据库，触发错误。

解决：

检查前端请求的URL：确保请求地址指向Express服务器的端口（比如http://localhost:4000/api/register），而非Next.js默认的3000端口。
排查Next.js项目中是否存在pages/api/register.js文件，若存在且未正确配置数据库连接，要么删除该文件，要么在其中添加正确的.env加载逻辑。

2. 修正`dotenv`的加载路径

如果database.js不在项目根目录，require('dotenv').config()默认会从当前文件目录查找.env，导致无法读取根目录的配置。虽然服务器启动时可能因入口文件已加载.env而能连接，但模块重新加载时会出现凭据丢失。

解决：
在database.js中明确指定.env文件的绝对路径：

const path = require('path');
const mysql2 = require('mysql2');

// 按实际目录层级调整路径，确保指向根目录的.env
require('dotenv').config({ path: path.resolve(__dirname, '../.env') });

const connection = mysql2.createConnection({
  host: process.env.DB_HOST,
  port: process.env.DB_PORT,
  user: process.env.DB_USER,
  password: process.env.DB_PASS,
  database: process.env.DB_NAME
});

connection.connect((err) => {
  if (err) {
    console.error('Error connecting to the database:', err);
    return;
  }
  console.log('Connected to database.');
});

module.exports = connection.promise();

3. 改用连接池替代单一连接

mysql2的createConnection创建的是单一连接，若连接因超时、数据库重启等原因断开，重连时可能出现凭据读取异常。连接池会自动管理连接生命周期，避免此类问题。

解决：
修改database.js为连接池模式：

const mysql2 = require('mysql2/promise');
const path = require('path');

require('dotenv').config({ path: path.resolve(__dirname, '../.env') });

const pool = mysql2.createPool({
  host: process.env.DB_HOST,
  port: process.env.DB_PORT,
  user: process.env.DB_USER,
  password: process.env.DB_PASS,
  database: process.env.DB_NAME,
  connectionLimit: 10, // 可根据需求调整连接数
  waitForConnections: true
});

// 测试连接
pool.getConnection()
  .then(conn => {
    console.log('Connected to database.');
    conn.release();
  })
  .catch(err => console.error('Error connecting to the database:', err));

module.exports = pool;

注册路由的execute调用无需修改，仍可使用await pool.execute(query, [...params])。

4. 排查环境变量是否被意外覆盖

检查项目中是否有其他代码（如全局中间件、第三方库）修改了process.env中的数据库凭据，导致接口调用时凭据变为空值。

解决：
在database.js和注册路由中添加日志，确认环境变量的取值：

// 在database.js开头添加
console.log('Loaded DB credentials:', {
  user: process.env.DB_USER,
  password: process.env.DB_PASS ? '***' : undefined
});

// 在注册路由的try块开头添加
console.log('Runtime DB credentials:', {
  user: process.env.DB_USER,
  password: process.env.DB_PASS ? '***' : undefined
});

若日志显示凭据为空，需追踪代码中修改process.env的逻辑。

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