Tomcat + MySQL 資料庫連線池配置完整指南 (DBCP)

環境準備

1. 下載 mm.mysql-2.0.14-bin.jar (MySQL JDBC Driver)
2. 放置於 $TOMCAT_HOME/common/lib/ 目錄

Server.xml 連線池配置

在 </Host> 標籤前加入：

<!-- MySQL Database Connection Pool -->
<Context path="/APPLICATION_NAME"
         docBase="APPLICATION_NAME"
         debug="5"
         reloadable="true"
         crossContext="true">

  <Logger className="org.apache.catalina.logger.FileLogger"
          prefix="localhost_DBTest_log."
          suffix=".txt"
          timestamp="true"/>

  <Resource name="jdbc/DATABASE_NAME"
            auth="Container"
            type="javax.sql.DataSource"/>

  <ResourceParams name="jdbc/DATABASE_NAME">
    <parameter>
      <name>factory</name>
      <value>org.apache.commons.dbcp.BasicDataSourceFactory</value>
    </parameter>

    <!-- JDBC Driver Class -->
    <parameter>
      <name>driverClassName</name>
      <value>org.gjt.mm.mysql.Driver</value>
    </parameter>

    <!-- Connection URL with autoReconnect -->
    <parameter>
      <name>url</name>
      <value>jdbc:mysql://localhost:3306/DATABASE_NAME?autoReconnect=true</value>
    </parameter>

    <parameter>
      <name>username</name>
      <value>DB_USERNAME</value>
    </parameter>

    <parameter>
      <name>password</name>
      <value>DB_PASSWORD</value>
    </parameter>

    <!-- Max connections in pool (0 = unlimited) -->
    <parameter>
      <name>maxActive</name>
      <value>100</value>
    </parameter>

    <!-- 其他常用參數 -->
    <parameter>
      <name>maxIdle</name>
      <value>30</value>
    </parameter>
    <parameter>
      <name>maxWait</name>
      <value>10000</value>
    </parameter>
    <parameter>
      <name>validationQuery</name>
      <value>SELECT 1</value>
    </parameter>
    <parameter>
      <name>testOnBorrow</name>
      <value>true</value>
    </parameter>
    <parameter>
      <name>removeAbandoned</name>
      <value>true</value>
    </parameter>
    <parameter>
      <name>removeAbandonedTimeout</name>
      <value>60</value>
    </parameter>
    <parameter>
      <name>logAbandoned</name>
      <value>true</value>
    </parameter>
  </ResourceParams>
</Context>

關鍵參數說明

JSP/Servlet 使用範例

Context initCtx = new InitialContext();
Context envCtx = (Context) initCtx.lookup("java:comp/env");
DataSource ds = (DataSource) envCtx.lookup("jdbc/DATABASE_NAME");
Connection conn = ds.getConnection();
// 使用連線...
conn.close(); // 歸還連線池，非關閉實體連線

web.xml 資源參考宣告

<resource-ref>
  <description>MySQL DBCP Connection Pool</description>
  <res-ref-name>jdbc/DATABASE_NAME</res-ref-name>
  <res-type>javax.sql.DataSource</res-type>
  <res-auth>Container</res-auth>
</resource-ref>

注意事項

• 確保 MySQL max_connections 足夠大（含連線池數量 + 其他連線）
• Tomcat 5.5+ 需額外複製 commons-dbcp.jar、commons-pool.jar 至 common/lib
• 生產環境建議啟用 testOnBorrow 與 validationQuery 防止斷線
• 定期監控連線池使用狀況，調整 maxActive、maxIdle