打开任何一个Java或Spring Boot项目，大概率能在里撞见一个。这东西看着就几行缩进加冒号，但一碰上数据库配置，翻车现场比比皆是。有人把密码明文怼进去，结果代码仓库一公开，数据库裸奔；有人图省事把连接串写死，换环境时改到怀疑人生；还有人被坑了整整一个下午，发现是YAML解析时把特殊字符吞了。今天这篇不整虚的，直接拿yml配置数据库这件事儿，把那些踩过的坑、该记的招，掰开揉碎讲清楚。
先别急着写代码，你得明白yml这玩意儿解析规则有多拧巴。它靠缩进表示层级，但你要是用Tab缩进，直接报错没商量。数据库配置里最常见的错误，就是那行带了个符号，比如。YAML解析器看到就以为你要定义锚点，结果整个字符串被截断，连接串报废。解决办法很简单，用双引号把整个URL包起来——。记住，凡是带特殊字符的值，一律加引号，别跟解析器玩暧昧。
再来说连接池。很多人yml里就写个、、，完事儿。真上了生产环境，并发一上来，连接池配置不合适，直接把你数据库拖垮。HikariCP是Spring Boot默认连接池，但你得主动调参。比如，默认10，你压测发现吞吐上不去，就该往20、30调。但注意，别盲目调大，连接数超过数据库本身能扛的极限，反而适得其反。还有，默认30秒，你接口响应要求200毫秒内，那连接等待超时就得设短点。这些参数全放yml里，层级是下面，一个一个写清楚，别嫌多。
多环境配置是yml的核心优势，但也是新手最容易搞砸的地方。你搞三个文件：、、，然后在主配置里写。但问题来了——数据库密码这玩意儿，dev和test环境用弱密码无所谓，prod环境你总不能也明文写吧？正确做法是，主yml里只放公共项，比如驱动类名、方言。环境专属的配置放各自文件里。prod环境那个yml，密码用环境变量占位，比如，然后在服务器上设好环境变量。这样就算代码泄露，生产库密码也安全。别嫌麻烦，这是底线。
说到敏感信息，还有个进阶玩法叫配置加密。Jasypt这个库，可以让你在yml里写加密后的密文，启动时用密钥解密。具体操作不复杂：pom里加依赖，主类加注解，然后在yml里写，需要加密的值用包裹。但这里有个坑，密钥本身如果也写进yml，那等于白加密。正确做法是，密钥从启动参数传，。或者用环境变量。加密的目的是让数据库密码不裸奔在代码仓库里，而不是给你自己添堵。
再聊聊连接串里那些参数，很多人忽略了它们对性能的影响。比如，开发环境无所谓，生产环境必须开SSL，否则数据明文传输，被截胡了都不知道。还有，这个参数对批量插入性能提升巨大，默认是false，你不开的话，一次插入1000条记录，MySQL会一条一条执行，开了之后，会合并成一条批量语句，性能提升好几倍。这些参数都写在URL的query string里，用连接。注意，在yml里写URL时，整个字符串用双引号包住，不然又得坑你一次。
说个实战中容易忽略的点：yml文件编码问题。有些IDE默认用GBK保存文件，你写个中文注释或者中文数据库名，运行起来直接乱码，连接失败。解决办法是，在IDE里把文件编码统一设为UTF-8，同时项目构建工具里也指定编码。另外，yml文件里别用中文写值，数据库连接串、用户名、密码，老老实实用英文和数字。不是歧视中文，是这玩意儿跨平台、跨环境最容易出幺蛾子。你永远不知道同事的电脑是什么编码，也不知道线上服务器默认什么字符集。省心比什么都强。
写了这么多，其实核心就一句话：yml配置数据库，不是把几个键值对填完就完事。你得理解它解析的脾气，知道特殊字符怎么处理，懂得用多环境隔离敏感信息，学会调连接池参数，必要时上加密。这些都是实打实能让你少加班的技巧。下次再改数据库配置，别急着复制粘贴，先想想这几点，多花两分钟，省下的可能是整个下午的排查时间。配置这活儿，看着简单，但细节里全是魔鬼。
