您现在的位置：程式碼之家 >> 數據庫知識 > >> SQL Server 資料庫 >> 關於SqlServer

Tomcat 整合 SQL Server 2008 連線池設定完整教學 (JNDI/DataSource)

編輯：關於SqlServer

前言

在 Java Web 應用中，透過 Tomcat 內建的 JNDI 資料源管理資料庫連線池，能集中設定、提升效能、簡化應用程式碼。本文以 SQL Server 2008 + Tomcat 6 為例，詳細說明 JDBC 驅動部署、context.xml、web.xml 設定、測試 JSP 範例，並說明常見坑點。

一、環境準備

Tomcat 6.0.10 (或更新版本)
SQL Server 2008
JDBC 驅動：sqljdbc4.jar (對應 Java 6/7/8) 或 mssql-jdbc-x.x.x.jre8.jar (新版)

二、部署 JDBC 驅動

將驅動 JAR 放入 Tomcat 共用類別路徑：

# Linux/macOS
cp sqljdbc4.jar $CATALINA_HOME/lib/

# Windows
copy sqljdbc4.jar %CATALINA_HOME%\lib\

注意：請勿放在應用程式 WEB-INF/lib，否則各應用會載入各自副本，無法共用連線池且易造成類別衝突。

三、設定全域資料源

編輯 $CATALINA_HOME/conf/context.xml，在 <Context> 內新增 <Resource>：

<Resource name="jdbc/TestDB"
          auth="Container"
          type="javax.sql.DataSource"
          maxActive="100"
          maxIdle="30"
          maxWait="10000"
          username="sa"
          password="YourStrongPassword"
          driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"
          url="jdbc:sqlserver://localhost:1433;databaseName=CuLeg;encrypt=true;trustServerCertificate=true"
          validationQuery="SELECT 1"
          testOnBorrow="true"
          testWhileIdle="true"
          timeBetweenEvictionRunsMillis="30000"
          minEvictableIdleTimeMillis="60000" />

關鍵屬性說明

屬性	建議值	說明
maxActive	100	最大活躍連線數，依應用併發與 DB 最大連線數調整。
maxIdle	30	最大閒置連線數，避免頻繁建立/銷毀開銷。
maxWait	10000	取得連線最長等待毫秒數，超過拋出例外。
validationQuery	SELECT 1	借用連線前驗證有效性，防止斷線存活問題。
testOnBorrow	true	每次借用時驗證。
encrypt / trustServerCertificate	true	SQL Server 2008+ 預設要求加密連線，驅動 6.0+ 需額外指定。

四、應用程式資源參照

編輯應用程式 WEB-INF/web.xml，宣告資源參照：

<resource-ref>
    <description>DB Connection</description>
    <res-ref-name>jdbc/TestDB</res-ref-name>
    <res-type>javax.sql.DataSource</res-type>
    <res-auth>Container</res-auth>
</resource-ref>

五、JSP 測試程式

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ page import="java.sql.*, javax.sql.*, javax.naming.*" %>
<%@ page session="false" %>
<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>JNDI DataSource Test</title>
</head>
<body>
    <h1>Hello, test JNDI!</h1>
    <%
        DataSource ds = null;
        Connection conn = null;
        Statement stmt = null;
        ResultSet rs = null;
        try {
            InitialContext ctx = new InitialContext();
            ds = (DataSource) ctx.lookup("java:comp/env/jdbc/TestDB");
            conn = ds.getConnection();
            stmt = conn.createStatement();
            rs = stmt.executeQuery("SELECT * FROM account");
            while (rs.next()) {
                out.println("第一欄: " + rs.getString(1) + "<br>");
                out.println("第二欄: " + rs.getString(2) + "<br>");
            }
            out.println("<br>JDBC 操作成功！");
        } catch (Exception e) {
            out.println("<font color='red'>錯誤: " + e.getMessage() + "</font>");
            e.printStackTrace();
        } finally {
            if (rs != null) try { rs.close(); } catch (Exception ignore) {}
            if (stmt != null) try { stmt.close(); } catch (Exception ignore) {}
            if (conn != null) try { conn.close(); } catch (Exception ignore) {}
        }
    %>
</body>
</html>

六、常見問題排除

ClassNotFoundException：驅動 JAR 未放入 $CATALINA_HOME/lib 或檔名錯誤。
NameNotFoundException: jdbc/TestDB：context.xml 的 name 與 web.xml res-ref-name 不一致，或 JNDI 路徑錯誤 (需為 java:comp/env/jdbc/TestDB)。
SSL/TLS 連線失敗：SQL Server 2008+ 預設強制加密，驅動 6.0+ 需在 URL 加 encrypt=true;trustServerCertificate=true (測試環境) 或匯入正式憑證。
連線洩漏：務必在 finally 區塊關閉 ResultSet、Statement、Connection，歸還連線池。

七、進階建議

生產環境密碼勿明文寫在 context.xml，可使用 Tomcat PasswordEncoder 或外部化設定 (如 Spring Cloud Config、HashiCorp Vault)。
監控連線池指標：numActive、numIdle、maxWaitTime，透過 JMX 或 Prometheus 收集。
定期執行 validationQuery 清理失效連線，避免防火牆斷開長閒置連線。