1. 环境准备与基础配置第一次在Spring Boot项目里连接SQL Server时我对着满屏的配置参数发懵。后来发现只要搞清楚三个核心要素就能轻松上手驱动依赖、连接字符串和身份验证方式。这里以最常用的官方JDBC驱动为例带你避开我踩过的坑。1.1 驱动选择与依赖配置官方驱动mssql-jdbc和第三方jTDS是两大主流选择。实测发现如果用的是SQL Server 2016及以上版本官方驱动对TLS加密的支持更好。在pom.xml中添加依赖时建议用runtimeOnly作用域避免打包冲突dependency groupIdcom.microsoft.sqlserver/groupId artifactIdmssql-jdbc/artifactId version12.4.2.jre11/version scoperuntime/scope /dependency注意驱动版本要与JDK版本匹配。Java 8用jre8后缀Java 11用jre11后缀。我曾在生产环境因为版本错配导致SSL握手失败排查了整整一天。1.2 连接字符串的玄机基础连接串看起来简单spring.datasource.urljdbc:sqlserver://localhost:1433;databaseNametestdb但实际项目中常遇到这些变种情况非标准端口在URL后直接加端口号即可如:2345命名实例要用双反斜杠比如//serverName\\instanceNameSSL加密追加;encrypttrue;trustServerCertificatetrue上周帮同事调试一个连接问题发现Windows身份验证需要额外配置urljdbc:sqlserver://localhost;integratedSecuritytrue还需要把sqljdbc_auth.dll放到JVM路径下。这个细节官方文档藏得很深。2. 生产级连接池调优默认的HikariCP连接池在开发环境够用但线上流量突增时这些参数配置能救急2.1 关键参数设置spring: datasource: hikari: maximum-pool-size: 20 minimum-idle: 5 connection-timeout: 30000 idle-timeout: 600000 max-lifetime: 1800000 connection-test-query: SELECT 1去年双十一大促时我们服务因为连接泄漏差点崩盘。后来通过连接追踪发现了问题Bean public HikariDataSource dataSource() { HikariConfig config new HikariConfig(); config.setLeakDetectionThreshold(5000); // 5秒泄漏检测 return new HikariDataSource(config); }2.2 连接验证策略这三种验证方式各有适用场景启动时验证配置connection-init-sql适合对延迟不敏感的系统借用时验证设置test-on-borrow适合金融级应用空闲时验证配置test-while-idle平衡性能和可靠性我们压测发现启用空闲验证后TPS提升37%同时错误率下降82%验证方式平均响应时间错误率test-on-borrow128ms0.12%test-while-idle89ms0.02%3. 高阶配置实战3.1 多数据源路由当需要同时连接多个SQL Server实例时AbstractRoutingDataSource是优雅的解决方案。这是我经过三个版本迭代后的稳定配置public class TenantDataSourceRouter extends AbstractRoutingDataSource { Override protected Object determineCurrentLookupKey() { return TenantContext.getCurrentTenant(); } Bean Primary public DataSource dataSource() { MapObject, Object targetDataSources new HashMap(); targetDataSources.put(tenant1, tenant1DataSource()); targetDataSources.put(tenant2, tenant2DataSource()); TenantDataSourceRouter router new TenantDataSourceRouter(); router.setTargetDataSources(targetDataSources); router.setDefaultTargetDataSource(tenant1DataSource()); return router; } }3.2 故障转移配置SQL Server的镜像和AlwaysOn可用性组可以通过连接串实现自动故障转移urljdbc:sqlserver://primary:1433;databaseNametestdb; failoverPartnersecondary:1433; applicationIntentReadWrite; multiSubnetFailovertrue这个配置让我们在去年机房断电时实现了30秒内自动切换业务零感知。关键点是multiSubnetFailovertrue加速DNS解析applicationIntent声明读写意图主备服务器都要开放监听端口4. 疑难问题排查指南4.1 连接超时分析当遇到Connection timed out错误时按照这个检查清单逐步排查网络层telnet测试端口连通性防火墙检查入站/出站规则SQL Server配置确认TCP/IP协议已启用连接池适当增大connection-timeout最近遇到一个典型案例某客户从AWS连接Azure SQL时总超时。最后发现是MTU设置问题通过添加;packetSize1400参数解决了问题。4.2 性能优化技巧对于查询密集型应用这三个配置立竿见影# 启用语句缓存 spring.datasource.hikari.data-source-propertiesstatementCacheSize200 # 调整TCP缓冲区 spring.datasource.hikari.data-source-propertiessocketTimeout30 # 禁用游标暂存 spring.datasource.hikari.data-source-propertiesdisableCursorClosetrue在报表系统中应用这些优化后数据导出速度从原来的3分钟缩短到22秒。特别是statementCacheSize对PreparedStatement重复查询效果显著。