生产环境 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 检查所有同名账户记录,不能只确认控制面板中是否显示了 %。
可以要求支持人员核查以下内容:
u635686762_toppersAdmin是否存在于实际收到连接的 MySQL 服务器上。- 是否有比
%更具体的Host记录。 - 来自
13.60.50.191的失败连接最终匹配了哪条账户记录。 - 账户是否被锁定,认证插件是否与成功连接时一致。
- Remote MySQL 面板设置是否已经同步到实际的 MySQL 权限表。
- 托管平台是否额外限制 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。生产环境的密码掩码已经表明,应用收到的密码与本地不同。
建议的处理顺序
- 立即轮换已经公开的数据库密码和调试密钥。
- 删除生产环境的
/api/debug,至少停止输出所有环境变量值。 - 核对正确的数据库主机,查清
193.203.184.84与89.116.133.144为什么不同。 - 正确处理密码中的
$,然后重新构建并部署。 - 在相同的生产运行环境中执行最小
mysql2连接测试。 - 如果仍然返回 1045,让 Hostinger 检查同名账户的所有
Host记录和失败认证日志。 - 服务端确认必须使用 IP allowlist 后,再处理 Amplify 固定出口 IP。
- 连接恢复后,再检查 SSL 要求、连接池大小和数据库权限,避免同时排查多个问题。
现有证据最直接地指向生产密码中的 $here1 被展开或截断。数据库主机不一致也必须尽快确认。当前 mysql2/promise 连接池代码中,没有发现会单独导致 1045 的明显逻辑错误。
备注:内容仅供参考。
