ZK 框架報錯：缺少 captcha 引擎類別，補齊 zkex.jar 即可解決

ZK 專案啟動時拋出異常：

org.zkoss.zk.ui.UiException: Library property, org.zkoss.zul.captcha.engine.class, required

根本原因

專案缺少 zkex.jar 函式庫，此 jar 包含驗證碼引擎實作類別。

解決步驟

1. 確認專案建置路徑（Build Path）是否包含 zkex.jar
2. 若使用 Maven，檢查 pom.xml 依賴：

<dependency>
  <groupId>org.zkoss.zk</groupId>
  <artifactId>zkex</artifactId>
  <version>${zk.version}</version>
</dependency>

3. 若為手動管理 jar，從 ZK 官網下載對應版本的 zkex.jar 放入 WEB-INF/lib
4. 重新部署專案，錯誤即可消除

補充說明

ZK 核心模組 zk.jar 不包含驗證碼、圖表、試算表等進階元件，這些功能均在 zkex.jar 與 zkmax.jar 中。專案若使用 <captcha> 元件，必須引入 zkex。