网站刚上线,用户一访问就报数据库连接错误,这种事太常见了。我见过不少团队在发布当天手忙脚乱,开发环境跑得好好的,一上生产就崩,十有八九是数据库链接这块出了岔子。别急着怀疑代码逻辑,先把下面这几个坑挨个排查一遍,大部分问题半小时内就能定位。
头一个高频原因是配置文件没跟着环境走。开发时数据库地址写的是`localhost`或者内网IP,打包发布时忘了改,或者环境变量没注入。比如某电商项目上线后首页白屏,日志里全是`Connection refused`,最后发现是生产环境的`DB_HOST`还指向测试库的域名,而测试库早被回收了。解决办法很简单:检查发布包里所有涉及数据库连接的配置项——主机、端口、库名、用户名、密码,确认它们跟目标环境一致。现在很多框架用`.env`文件,记得确认这个文件有没有被误提交或者漏传。要是用容器部署,检查`docker-compose.yml`或者K8s的ConfigMap,别让环境变量覆盖了正确值。
第二个常见坑是数据库服务压根没起来,或者监听地址不对。有人以为云数据库买完就能用,结果安全组没放行应用服务器的IP,连接超时。我遇到过一个小团队,发布后所有请求都卡在数据库连接上,查了半天发现RDS的白名单只加了办公室的出口IP,线上服务器根本不在里面。还有个情况是数据库只监听了`127.0.0.1`,应用服务器通过内网IP连过去自然被拒。去数据库服务器上跑一下`netstat -tlnp | grep 3306`(以MySQL为例),看看监听地址是`0.0.0.0`还是`127.0.0.1`。如果是后者,改配置文件里的`bind-address`,重启服务。
连接字符串的细节也容易翻车。比如密码里带了特殊字符`@`或者`#`,在URL里没做转义,解析出来密码就错了。有个做SaaS的朋友,生产库密码用了随机生成的`p@ssw0rd!`,结果连接串写成`mysql://user:p@ssw0rd!@host/db`,驱动直接把`p`当密码,`ssw0rd!@host`当主机名,报错信息还特别模糊。遇到这种,要么用连接参数分开传,要么把特殊字符做百分号编码。另外注意字符集参数,生产库如果强制`utf8mb4`,连接串里没指定,某些驱动会默认用`latin1`,插入中文直接乱码,严重时连接握手就失败。
连接池配置不当也会在发布后暴露。开发环境并发低,连接池设个5到10没感觉;线上一上来几百个请求,池子瞬间打满,后面的请求排队等连接,超时后报`Unable to acquire JDBC Connection`。这时候别急着调大最大连接数,先看看数据库那边的`max_connections`够不够。MySQL默认才151,应用池子设了200,数据库直接拒绝新连接。合理做法是应用侧最大连接数不超过数据库上限的80%,再配合合理的超时和重试。有个做在线教育的案例,发布当晚流量冲上来,数据库连接数飙到上限,DBA紧急调高`max_connections`才缓过来。事后他们把连接池从50降到30,同时加了连接泄漏检测,问题再没复现。

防火墙和网络策略是另一个隐形杀手。云服务器安全组、VPC网络ACL、主机iptables三层都可能拦。发布后先在一台应用服务器上用`telnet 数据库IP 端口`测一下通不通。如果不通,逐层查:安全组入方向规则有没有放行应用服务器所在网段;如果用了K8s的NetworkPolicy,确认Pod的出站规则允许访问数据库端口;主机上的`iptables -L -n`看看有没有默认DROP。别忽略IPv6的情况,有时候应用服务器优先走IPv6去连数据库,但数据库没配IPv6地址,连接直接失败,日志里却只显示超时。
还有一类问题跟DNS有关。连接串里写的是数据库域名,发布后应用服务器解析不到,或者解析到旧IP。比如某公司把数据库从自建机房迁到云上,域名没改,但DNS缓存TTL设了24小时,发布后新服务器拿到的还是老IP。临时办法是在应用服务器的`/etc/hosts`里写死正确IP,长期得把TTL调低并刷新缓存。另外有些容器环境里DNS配置有问题,`/etc/resolv.conf`指向的DNS服务器不响应,导致连接超时。进容器里`nslookup 数据库域名`验证一下。
最后提一个容易被忽略的:数据库版本和驱动不兼容。开发环境用MySQL 5.7,生产库升级到8.0,老版本JDBC驱动连8.0默认的`caching_sha2_password`认证方式会报`Public Key Retrieval is not allowed`。要么升级驱动,要么在连接串加`allowPublicKeyRetrieval=true&useSSL=false`(仅限内网可信环境)。还有PostgreSQL升级大版本后,默认的`scram-sha-256`认证方式老驱动也不认,同样得换驱动。发布前把数据库版本和驱动版本对一遍,能省掉半夜爬起来改配置的麻烦。
排查顺序建议从外到内:先测网络通不通,再看数据库服务状态,然后核对连接配置,最后查连接池和驱动。每步都有明确的命令和日志可看,别一上来就重启服务。大部分数据库链接问题在发布后十分钟内就能定位,关键是别慌,按链路一步步缩小范围。