PAYATHON 2026

生产环境 Next.js 连接 MySQL 报 Access denied

排障赵师傅

结论

这次报错应先检查生产环境密码。现有证据暂时没有指向 Next.js 或 mysql2 代码。

两份调试响应中的密码掩码不同:

  • 本地密码掩码:Thi...re1
  • 生产密码掩码:Thi...You

给出的密码包含 $:

ThisIsYou$here1

如果这个值经过 Shell、构建脚本或支持变量展开的 .env 解析器,$here1 可能会被当作变量引用。变量不存在时,应用实际收到的密码可能只剩:

ThisIsYou

对应的掩码正是 Thi...You,与生产响应一致。

本地和生产环境使用的数据库地址也不同:

本地:193.203.184.84
生产:89.116.133.144

所以两边并未使用完全相同的连接参数。除了密码可能被截断,还要排查生产环境是否填错了数据库主机,或者连接到了另一个 MySQL 实例。

Access denied for user ...@'13.60.50.191' 表明 TCP 连接已经到达 MySQL。如果端口被防火墙直接阻断,通常会出现超时、ECONNREFUSED 或 ETIMEDOUT,不会收到 MySQL 返回的 ER_ACCESS_DENIED_ERROR。

修复生产环境密码

不要用未加引号的 Shell 命令设置包含 $ 的密码:

export MYSQL_PASSWORD=ThisIsYou$here1

Shell 可能会展开 $here1。这里应使用单引号:

export MYSQL_PASSWORD='ThisIsYou$here1'

如果密码写在 Next.js 的 .env 文件中,需要注意 Next.js 会展开 $VARIABLE 形式的内容。字面量 $ 应转义:

MYSQL_PASSWORD=ThisIsYou\$here1

通过 AWS Amplify 或 Hostinger 控制台填写环境变量时,要确认平台保存的是字面值,没有将其作为 Shell 表达式写入构建脚本。修改后应重新构建并部署应用。只重启旧实例,不一定能更新构建阶段注入的变量。

验证时,可以临时设置一个不含 $、反引号、引号和反斜杠的数据库密码,然后重新部署并测试。连接恢复后,再改用随机生成的强密码,并按平台要求保存。

问题中公开过的密码应视为已经泄露,不能继续使用。

确认连接的是同一个数据库实例

本地成功响应使用:

MYSQL_HOST=193.203.184.84

生产失败响应使用:

MYSQL_HOST=89.116.133.144

先向 Hostinger 确认该数据库账户对应的远程 MySQL 主机。网站服务器 IP、面板 IP 或 DNS 解析结果都不能直接用来推断数据库地址。

可以从本地分别测试这两个地址:

mysql \
  --host=193.203.184.84 \
  --port=3306 \
  --user=u635686762_toppersAdmin \
  --password \
  u635686762_toppers_track
mysql \
  --host=89.116.133.144 \
  --port=3306 \
  --user=u635686762_toppersAdmin \
  --password \
  u635686762_toppers_track

如果只有第一个地址可以登录,说明生产环境的 MYSQL_HOST 填错了。如果两个地址都能登录,再执行以下查询,确认它们是否属于同一个实例:

SELECT
  @@hostname AS server_hostname,
  @@port AS server_port,
  DATABASE() AS current_database,
  USER() AS login_identity,
  CURRENT_USER() AS matched_account;

其中:

  • USER() 显示客户端提交的用户名,以及 MySQL 看到的连接来源。
  • CURRENT_USER() 显示 MySQL 最终匹配的账户记录,例如 'user'@'%'。

% 不能绕过网络和账户限制

MySQL 账户由 User 和 Host 共同确定:

'u635686762_toppersAdmin'@'%'

% 表示这条 MySQL 账户记录可以匹配任意来源主机,但以下限制仍然有效:

  • 托管商控制面板中的 Remote MySQL allowlist
  • 主机防火墙或云防火墙
  • MySQL 监听地址限制
  • 托管商针对云服务商网段的策略
  • 更具体的 MySQL 账户记录
  • 账户锁定、密码或认证插件问题

MySQL 会优先选择更具体的 Host 记录。例如同时存在:

'u635686762_toppersAdmin'@'%'
'u635686762_toppersAdmin'@'13.60.50.191'

当连接来自 13.60.50.191 时,MySQL 可能会匹配第二条记录。如果该记录使用了不同的密码、处于锁定状态或配置了不同的认证插件,仍会返回错误 1045。

拥有管理权限时,可以检查:

SELECT
  User,
  Host,
  plugin,
  account_locked
FROM mysql.user
WHERE User = 'u635686762_toppersAdmin';

再检查授权:

SHOW GRANTS FOR 'u635686762_toppersAdmin'@'%';

共享主机通常不允许普通用户读取 mysql.user。遇到这种情况,需要让 Hostinger 检查所有同名账户记录,不能只确认控制面板中是否显示了 %。

可以要求支持人员核查以下内容:

  1. u635686762_toppersAdmin 是否存在于实际收到连接的 MySQL 服务器上。
  2. 是否有比 % 更具体的 Host 记录。
  3. 来自 13.60.50.191 的失败连接最终匹配了哪条账户记录。
  4. 账户是否被锁定,认证插件是否与成功连接时一致。
  5. Remote MySQL 面板设置是否已经同步到实际的 MySQL 权限表。
  6. 托管平台是否额外限制 AWS、数据中心或动态出口 IP。

根据错误类型判断问题位置

可以用错误类型快速缩小排查范围:

现象更可能的问题
ETIMEDOUT防火墙、路由、端口未开放或 IP allowlist
ECONNREFUSED端口未监听、目标地址错误或服务未运行
ENOTFOUND数据库主机名或 DNS 错误
ER_ACCESS_DENIED_ERROR / 1045用户名、密码、来源主机匹配、账户状态或认证方式
Access denied ... to database登录成功,但缺少目标数据库权限
TLS/SSL 相关错误服务端要求 SSL,或证书配置不正确

当前错误表示 MySQL 主动拒绝了认证。网络策略仍可能影响认证,但现阶段没有迹象表明 3306 端口完全无法访问。

在生产运行环境中单独测试

除了 Next.js API route,还可以在同一个托管运行环境中运行一个最小 Node.js 脚本,以排除应用业务代码的影响:

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

async function main() {
  const connection = await mysql.createConnection({
    host: process.env.MYSQL_HOST,
    port: Number(process.env.MYSQL_PORT || 3306),
    user: process.env.MYSQL_USER,
    password: process.env.MYSQL_PASSWORD,
    database: process.env.MYSQL_DATABASE,
    connectTimeout: 15000,
  });

  const [rows] = await connection.query(`
    SELECT
      @@hostname AS server_hostname,
      DATABASE() AS current_database,
      USER() AS login_identity,
      CURRENT_USER() AS matched_account
  `);

  console.log(rows);
  await connection.end();
}

main().catch((error) => {
  console.error({
    code: error.code,
    errno: error.errno,
    sqlState: error.sqlState,
    message: error.message,
  });
  process.exitCode = 1;
});

如果这个脚本仍然返回 1045,问题就在凭据、目标 MySQL 实例或服务端账户匹配上,与 Next.js API route 无关。

检查环境变量时不要输出秘密

现有 /api/debug 存在严重的安全风险:

  • 查询参数中的固定密钥已经公开。
  • 接口暴露了环境变量名称、数据库地址、用户名和秘密的部分字符。
  • URL 查询参数可能被记录到浏览器历史、访问日志、CDN 日志或监控系统。
  • 即使经过掩码处理,仍会泄露密码长度及首尾字符。

生产环境应删除这个端点。如果确实需要健康检查,只返回连接状态和非敏感错误码:

import { NextResponse } from 'next/server';
import { query } from '@/lib/mysql-db';

export const runtime = 'nodejs';

export async function GET() {
  try {
    await query('SELECT 1');
    return NextResponse.json({ database: 'ok' });
  } catch (error: any) {
    console.error('Database health check failed', {
      code: error?.code,
      errno: error?.errno,
      sqlState: error?.sqlState,
    });

    return NextResponse.json(
      {
        database: 'error',
        code: error?.code ?? 'UNKNOWN',
      },
      { status: 503 }
    );
  }
}

应立即轮换数据库密码、调试密钥以及可能受到影响的应用密钥。客户端 ID 和 Auth0 domain 通常不属于秘密,但数据库密码、JWT_SECRET 和 AUTH0_SECRET 不能通过调试接口返回。

AWS Amplify 出口 IP

错误中的 13.60.50.191 是 MySQL 实际看到的来源地址,但一次响应不足以证明它是永久出口 IP。托管或无服务器运行环境可能使用动态出口地址,重新部署、扩缩容或区域变化也可能导致 IP 更换。

如果 Hostinger 要求逐个添加来源 IP,而 Amplify 无法提供稳定的出口地址,长期方案通常是改用具有固定出口 IP 的运行环境,例如配置固定 NAT 出口、使用可控的 VPS,或将应用和数据库部署到支持私有网络连接的环境中。当前 Amplify 部署模式能否提供固定出口地址,需要结合实际托管方案确认。

应先修正密码和数据库地址,再处理出口 IP。生产环境的密码掩码已经表明,应用收到的密码与本地不同。

建议的处理顺序

  1. 立即轮换已经公开的数据库密码和调试密钥。
  2. 删除生产环境的 /api/debug,至少停止输出所有环境变量值。
  3. 核对正确的数据库主机,查清 193.203.184.84 与 89.116.133.144 为什么不同。
  4. 正确处理密码中的 $,然后重新构建并部署。
  5. 在相同的生产运行环境中执行最小 mysql2 连接测试。
  6. 如果仍然返回 1045,让 Hostinger 检查同名账户的所有 Host 记录和失败认证日志。
  7. 服务端确认必须使用 IP allowlist 后,再处理 Amplify 固定出口 IP。
  8. 连接恢复后,再检查 SSL 要求、连接池大小和数据库权限,避免同时排查多个问题。

现有证据最直接地指向生产密码中的 $here1 被展开或截断。数据库主机不一致也必须尽快确认。当前 mysql2/promise 连接池代码中,没有发现会单独导致 1045 的明显逻辑错误。

备注:内容仅供参考。