Spring Boot连PostgreSQL数据库，这事听起来简单，做起来却有不少坑。我见过太多人卡在连接不上、密码报错、时区错乱这些莫名其妙的问题上，一查原因，都是配置细节没搞明白。今天咱们就把这事掰开揉碎了说清楚，从零开始，一步步把PostgreSQL接进Spring Boot项目里。
先得说清楚，Spring Boot连接PostgreSQL，核心就三样东西：依赖、配置、驱动。少了哪个都不行，顺序错了也不行。很多人上来就复制粘贴配置文件里的内容，结果驱动没引入，或者版本对不上，直接报ClassNotFoundException。这就像你拿着钥匙去开门，结果门锁还没装，当然打不开。
先说依赖。Spring Boot官方对PostgreSQL的支持很成熟，你只需要在pom.xml里加两个东西：spring-boot-starter-jdbc（或者spring-boot-starter-data-jpa，看你用什么持久层框架）和org.postgresql:postgresql。驱动版本别乱指定，让Spring Boot自己管理就行。你要是手动指定个老版本，可能跟新版的PostgreSQL服务端协议不兼容，连接的时候会报protocol version mismatch，那真是欲哭无泪。
接下来是配置文件。我强烈建议你用application.yml而不是properties，因为YAML的层级结构清晰，不容易写错。关键配置就这几项：spring.datasource.url、spring.datasource.username、spring.datasource.password。URL的格式是jdbc:postgresql://主机地址:端口号/数据库名，后面再跟参数。比如jdbc:postgresql://localhost:5432/mydb?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai。这里有几个坑，第一个是时区，PostgreSQL默认返回的是UTC时间，你本地是东八区，如果不指定serverTimezone，查出来的时间全部差8小时。第二个是编码，不指定characterEncoding，中文乱码能烦死你。
再说驱动类。Spring Boot 2.x以后，PostgreSQL的驱动类名是org.postgresql.Driver，这个不用你手动指定了，Spring Boot会自动识别。但你要是用了老版本的Spring Boot，比如1.x，那就得手动加spring.datasource.driver-class-name=org.postgresql.Driver。现在的项目基本都用2.x或3.x，这个问题很少遇到了，但万一你接手老项目，得知道这个差异。
连接池配置也是个关键点。Spring Boot默认用HikariCP，性能相当好，基本不用改。但有几个参数值得调一下。maximum-pool-size默认10，如果你的并发量不大，这个够用。但如果你有批量任务，或者同时跑的线程多，得调大，不然连接不够用，线程会排队等，性能急剧下降。另外connection-timeout默认30秒，如果数据库压力大，可能超时，建议设成60秒。还有idle-timeout，默认10分钟，如果连接空闲超时会被回收，频繁创建销毁连接也是个开销，适当调长点。
接下来聊聊密码加密的问题。很多项目直接把数据库密码明文写在application.yml里，这要是代码泄露到GitHub上，那数据库就裸奔了。建议用Jasypt或者Spring Cloud Config来加密。Jasypt的用法很简单，加个依赖，配置加密算法和密钥，然后在密码字段写ENC(加密后的密文)，运行的时候会自动解密。密钥不要写死在配置文件里，用环境变量传，比如JASYPTENCRYPTORPASSWORD。这样即使代码泄露，没有密钥也解不开密码。
还有个小细节，很多人忽略：PostgreSQL的schema和searchpath。默认情况下，连接的是public schema，如果你建表时用了自定义schema，不指定的话会报relation does not exist。解决办法是在URL里加currentSchema参数，比如?currentSchema=myschema。或者在配置文件里设置spring.jpa.properties.hibernate.defaultschema=myschema。这个坑我踩过，当时找了半天，发现是schema没对上。
测试连接这块，我建议你在写业务代码之前，先写个简单的Controller或者测试类，就查一下数据库版本，确认连通性。这样能快速定位是配置问题还是代码问题。比如写个@GetMapping("/test")，里面执行SELECT version()，返回结果就说明通了。别一上来就写一堆CRUD，结果连接都没通，排查起来头大。
提醒一点：如果你用的是Docker部署PostgreSQL，端口映射、数据卷、网络模式都得注意。Docker容器里的PostgreSQL默认端口是5432，你映射到宿主机可能用别的端口，比如5433，那URL里就得写5433。还有密码别用默认的postgres，太危险了。建议用强密码，并且限制访问IP。
Spring Boot连PostgreSQL，说到底就是耐心加细心。依赖引对了，配置写全了，连接池调好了，密码加密了，schema指定了，测试通过了，基本就没什么问题了。你要是按照这个顺序一步步来，踩坑的概率会小很多。如果实在遇到问题，别慌，看报错信息，第一行往往就是答案。祝你能顺利把PostgreSQL接进你的Spring Boot项目里，跑得又快又稳。
