我见过太多人在Docker容器连数据库这步翻车了。明明镜像拉下来了，容器也跑起来了，代码在本地跑得欢快，一放进容器里，数据库连接就报错。你盯着那串红色报错信息，心里嘀咕：这玩意儿在宿主机上好好的，怎么换个地儿就不认人了？其实问题就出在三个地方：网络模式、连接地址、还有环境变量。今天我把这三大配置要点掰开揉碎了讲，你照着配一遍，保证容器能稳稳当当连上数据库。
先说最容易踩坑的网络模式。Docker容器默认跑在bridge网络里，这个网络里的容器有自己独立的内网IP，跟宿主机不是一回事。你要是图省事，在代码里写localhost或者127.0.0.1去连数据库，那肯定连不上——因为localhost在容器里指的是容器自己，不是你的宿主机。这时候你有两条路走：要么把容器跑在host网络模式下，让容器直接共享宿主机的网络栈，这样localhost就能指向宿主机了；要么就用bridge网络，但连接地址得改成你宿主机的真实IP，或者用那个特殊的网关地址172.17.0.1（在Linux上通常是这个）。我建议新手直接用host模式，省心，但要注意端口冲突的问题。你要是用Mac或者Windows的Docker Desktop，那情况又不一样了，它内部跑了个轻量级虚拟机，你得用那个虚拟机的IP，或者干脆用host.docker.internal这个魔法域名。
第二个要点，也是大家问得最多的：连接地址到底怎么写。很多人以为把数据库地址从localhost改成宿主机IP就完事了，结果还是连不上。这里头有个细节你得注意——你宿主机上跑着防火墙没？如果开着，你得确保数据库端口在防火墙里是放行的。还有，你数据库监听的地址是127.0.0.1还是0.0.0.0？如果你只监听本地回环地址，那不管你怎么改容器里的连接地址，从外部都进不来。MySQL和PostgreSQL默认配置可能只监听localhost，你得去改配置文件，把bind-address或者listenaddresses改成0.0.0.0，让数据库接受来自任何网络接口的连接。这步做完，容器里的服务才能真正触达数据库。另外，容器里跑的应用如果用了环境变量来存数据库连接串，你记得别把IP写死在代码里，用环境变量替换掉，这样以后换环境不用改代码，改配置就行。
第三个要点，也是最容易被忽略的：容器和数据库之间的通信方式。很多人直接把数据库也装进容器里，然后两个容器之间互相访问。这时候你要是还用localhost去连另一个容器，那肯定是白费劲。容器之间得通过Docker网络来通信，你可以创建一个自定义bridge网络，然后把两个容器都挂到这个网络上，这样它们就能用容器名字当主机名互相访问了。比如你有个容器叫db，另一个叫app，app里连数据库写db:3306就行，Docker会帮你解析这个主机名。这种做法的好处是，不管容器IP怎么变，只要容器名不变，连接就不会断。你要是图省事，把数据库装在宿主机上，容器里用networkmode: host，那连接地址写localhost就行，但别忘了刚才说的防火墙和监听地址的问题，这俩坑照样等着你。
说到这，你可能会问，那我怎么知道配置到底对不对？调试方法我给你几个。容器起来了，先别急着跑应用，进容器里用ping或者telnet测一下目标地址通不通。比如docker exec -it 容器名 ping 数据库IP，能通说明网络层面没问题。再试试telnet 数据库IP 端口，看端口通不通。这两步都过了，说明网络链路是通的，问题可能出在认证或者数据库权限上。要是ping不通，你检查一下网络模式是不是选对了；要是端口不通，大概率是防火墙或者数据库监听地址的问题。这套排查思路能帮你快速定位问题出在哪一层，不用瞎猜。
还有个细节我得提醒你，数据库连接串里如果带了时区参数或者SSL配置，也会导致连接失败。有些数据库驱动默认要求SSL连接，但你的数据库没开SSL，那就会一直报错。你可以在连接串里显式地关闭SSL，比如MySQL的useSSL=false，PostgreSQL的sslmode=disable。还有字符集设置，如果数据库和容器里的字符集不一致，写入中文可能会乱码或者直接报错。这些看似不起眼的小配置，往往是压垮骆驼的一根稻草。我见过有人折腾了一整天，发现就是连接串里少了个参数。
再啰嗦一句，Docker Compose是个好东西，它能把上面这些配置固化下来。你在docker-compose.yml里定义好网络、环境变量、端口映射，以后一条docker-compose up -d就能把整个环境拉起来，不用每次手动敲docker run那一长串参数。Compose文件里还能定义healthcheck，让容器在数据库完全就绪之后再启动应用，避免那种应用先启动了、数据库还没准备好的尴尬局面。这种依赖管理在微服务架构里尤其重要，你总不想每次启动都要靠运气吧。
回到最开始说的三大配置要点，网络模式决定容器怎么看到外面的世界，连接地址决定代码里怎么写数据库的位置，通信方式决定容器和数据库之间怎么建立信任关系。这三样弄明白了，Docker容器连数据库就不是什么玄学。下次再遇到连接报错，别慌，按这三个方向排查，逐层验证，总能找到问题所在。配置这东西，说白了就是个映射关系，你把每层映射都搞清楚，自然就通了。
