Tomcat 8 資料庫連線池配置完整指南：全域共享 vs 專案獨立、JNDI 查找與測試

一、兩種配置策略對比

二、全域共享配置步驟

1. 修改 conf/context.xml (在 <Context> 內)

<Resource
    name="jdbc/myDataSource"
    auth="Container"
    type="javax.sql.DataSource"
    driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"
    url="jdbc:sqlserver://127.0.0.1\:1433;DatabaseName=ShopSystem"
    username="sa"
    password="xx"
    maxActive="20"
    maxIdle="10"
    maxWait="5000"
    validationQuery="SELECT 1"
    testOnBorrow="true"
    testWhileIdle="true"
    timeBetweenEvictionRunsMillis="30000"
    minEvictableIdleTimeMillis="60000"
    removeAbandonedOnBorrow="true"
    removeAbandonedTimeout="60"
    logAbandoned="true"
/>

關鍵屬性說明：

• maxActive：最大活躍連線數 (0=無限)。
• maxIdle：池中保留最大閒置連線。
• maxWait：取得連線最長等待毫秒數。
• validationQuery + testOnBorrow：借用前驗證連線有效，防斷連。
• removeAbandonedOnBorrow：自動回收泄漏連線 (超過 removeAbandonedTimeout 秒未歸還)。

2. 修改 conf/web.xml 或專案 WEB-INF/web.xml 宣告資源參考

<resource-ref>
    <res-ref-name>jdbc/myDataSource</res-ref-name>
    <res-type>javax.sql.DataSource</res-type>
    <res-auth>Container</res-auth>
</resource-ref>

三、專案獨立配置步驟

1. 建立 WebApp/META-INF/context.xml

<?xml version="1.0" encoding="UTF-8"?>
<Context>
    <Resource
        name="jdbc/myDS"
        auth="Container"
        type="javax.sql.DataSource"
        driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"
        url="jdbc:sqlserver://127.0.0.1\:1433;DatabaseName=ShopSystem"
        username="sa"
        password="xx"
        maxActive="10"
        maxIdle="5"
        maxWait="3000"
        validationQuery="SELECT 1"
        testOnBorrow="true"
    />
</Context>

2. 專案 WEB-INF/web.xml 宣告

<resource-ref>
    <res-ref-name>jdbc/myDS</res-ref-name>
    <res-type>javax.sql.DataSource</res-type>
    <res-auth>Container</res-auth>
</resource-ref>

四、必要條件：JDBC 驅動放入 tomcat/lib/

無論哪種策略，資料庫驅動 JAR (如 sqljdbc4.jar, mysql-connector-java.jar, ojdbc8.jar) 必須放在 $CATALINA_BASE/lib/，否則類別載入失敗 (ClassNotFoundException)。

五、JSP/Servlet 測試程式碼

<%@ page import="javax.naming.*, javax.sql.*, java.sql.*" %>
<%
    Context initCtx = new InitialContext();
    Context envCtx = (Context) initCtx.lookup("java:comp/env");
    DataSource ds = (DataSource) envCtx.lookup("jdbc/myDataSource"); // 或 jdbc/myDS
    try (Connection conn = ds.getConnection();
         Statement stmt = conn.createStatement();
         ResultSet rs = stmt.executeQuery("SELECT a_name FROM admin")) {
        while (rs.next()) {
            out.print(rs.getString("a_name") + "<br/>");
        }
    }
%>

六、Spring 整合 (補充)

<bean id="dataSource" class="org.springframework.jndi.JndiObjectFactoryBean">
    <property name="jndiName" value="java:comp/env/jdbc/myDataSource"/>
    <property name="resourceRef" value="true"/>
</bean>

或使用 <jee:jndi-lookup> 命名空間簡化。

七、常見坑點與排查

Q: NameNotFoundException: Name [jdbc/myDataSource] is not bound

A: 1) 確認 context.xml 的 name 與 web.xml res-ref-name 完全一致。
2) 確認查找路徑為 java:comp/env/jdbc/xxx (不可省略前綴)。
3) 專案獨立模式下，檢查 META-INF/context.xml 是否隨 WAR 部署 (部分 IDE 需配置資源複製)。

Q: 連線泄漏 / 長時間閒置後報 Communications link failure

A: 必開啟 validationQuery + testOnBorrow="true" (或 testWhileIdle + evictor 執行緒)。MySQL 8.0+ 建議 validationQuery="SELECT 1"。

Q: SQL Server 驅動類別名錯誤

A: sqljdbc4.jar 用 com.microsoft.sqlserver.jdbc.SQLServerDriver；mssql-jdbc 9.0+ 同類別名，確認 JAR 版本對應 JDK 版本。

Q: 專案獨立模式下修改 context.xml 不生效

A: Tomcat 會快取 conf/Catalina/localhost/專案名.xml，刪除該檔案並重新部署，或重啟 Tomcat。

八、效能調優建議

• maxActive 依據資料庫最大連線數與應用並發度設定 (通常 20~100)。
• 啟用 testWhileIdle + timeBetweenEvictionRunsMillis 定期清理斷連。
• 監控 numActive/numIdle (JMX 或 /manager/status) 動態調整。
• 考慮升級 HikariCP (Spring Boot 2+ 預設) 取代 Tomcat DBCP，效能更優、配置更簡潔。