Node.js使用mysql2连接数据库提示username配置无效如何解决

1. 核心报错原因 #

mysql2库的createConnection方法配置项中，用户名的正确参数名是user，不是username，这是触发警告的直接原因。

2. 修改参数后仍报错的排查点 #

如果已经把username改为user还是没有解决，可以按照以下顺序排查：

• 确认代码修改后已保存，且重启了本地运行的服务
• 检查项目中是否正确加载了.env文件，需要在代码最顶部引入dotenv配置，否则process.env.DB_PASS会是undefined，连带触发配置校验异常：

require('dotenv').config()

• 确认PORT变量的定义逻辑，不要把web服务的运行端口和mysql数据库的端口混用，mysql默认端口为3306，web服务常用端口为3000，二者不能填混
• 检查项目依赖安装情况，确认你require的是mysql2包，而非其他封装后的第三方mysql工具库

3. 修正后的完整参考代码 #

// 顶部优先加载dotenv配置
require('dotenv').config()
const mysql = require('mysql2')
const express = require('express')
const app = express()
// web服务端口不要和mysql端口冲突
const SERVER_PORT = process.env.SERVER_PORT || 3000

const connection = mysql.createConnection({
    host: "localhost",
    // 替换username为user
    user: "root",
    password: process.env.DB_PASS,
    // mysql默认端口3306，自定义端口的话修改为对应值
    port: 3306,
    database: "employee_tracker",
    }
);

connection.connect((err) => {
    if (err) {
        // 打印错误详情方便定位问题
        console.log("Error with connection: ", err)
    } else {
        console.log("Connected to Employee Tracker")
    }
    init();
})

app.listen(SERVER_PORT, () =>
  console.info(`Example app listening at http://localhost:${SERVER_PORT}`)
);

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