Activiti Explorer 整合 SQL Server 資料庫完整配置指南

目標

將 Activiti Explorer 預設 H2 內存資料庫切換為 SQL Server 持久化。

配置步驟

1. 修改 db.properties

路徑：WEB-INF/classes/db.properties

db=mssql
jdbc.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver
jdbc.url=jdbc:sqlserver://localhost:1433;databaseName=activiti
jdbc.username=sa
jdbc.password=your_password

2. 放入 JDBC 驅動

• 下載：Microsoft JDBC Driver for SQL Server
• 解壓取出 sqljdbc4.jar
• 複製至：WEB-INF/lib/

3. 啟用 SQL Server TCP/IP 協定

• 開啟 SQL Server Configuration Manager
• 網路設定 → 對應實例 → TCP/IP 設為「已啟用」
• 重啟 SQL Server 服務

4. 防火牆與連線驗證

• 關閉防火牆或開放 1433 連接埠
• 使用 SSMS 驗證 TCP/IP 連線成功

5. 建立 activiti 資料庫

手動建立空資料庫 activiti，啟動 Tomcat 時自動建表初始化。

6. 啟動驗證

• 啟動 Tomcat
• 訪問 https://localhost:8080/activiti-explorer
• 檢查資料庫表自動建立情況

MySQL 替代配置

db=mysql
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/activity
jdbc.username=root
jdbc.password=123456

同樣需放入 mysql-connector-java.jar 至 lib 目錄。

已知問題

BPMN 檔案包含中文部署後資料庫顯示亂碼，待進一步排查字元集設定（建議資料庫、連線字串、JVM 統一 UTF-8）。

總結

核心三步：修改 db.properties → 放入 JDBC 驅動 → 啟用 TCP/IP。啟動後自動建表初始化，無需手動執行 DDL。