Sybase **jConnect** 驅動預設不進行字符集轉換,若連線 URL 未顯式指定 `charset`,驅動將資料庫原始位元組按 `ISO-8859-1` 解碼為 Java `String`,導致中文資料在進入 JVM 前已永久損壞,**應用層任何轉碼均無法挽回**。
| 參數 | 說明 | 常見值 |
| charset | **關鍵**:告訴驅動資料庫使用的字符集,驅動據此將原始位元組正確解碼為 Unicode | `eucgb` (GBK/GB2312), `cp850` (西歐), `cp437` (美式), `utf8` (UTF-8), `iso_1` (ISO-8859-1) |
| jconnect_version | 指定 jConnect 協議版本,影響功能支援與效能 | `3` (jConnect 5.x), `4` (jConnect 6/7+, 預設) |
如何確認資料庫實際字符集
-- Sybase SQL 查詢
sp_configure "default character set id"
-- 或
select @@charset
-- 返回字符集 ID,對照 Sybase 文檔查名稱 (如 4 = cp850, 10 = eucgb)
或諮詢 DBA,或嘗試常見字符集逐一測試 (連線成功且中文正常即為正確)。
完整 JSP 連線範例
<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" import="java.sql.*" %>
<%
String url = "jdbc:sybase:Tds:192.168.1.100:5000/mydb?charset=eucgb&jconnect_version=4";
String user = "sa"; String pwd = "password";
Connection conn = null; Statement stmt = null; ResultSet rs = null;
try {
Class.forName("com.sybase.jdbc4.jdbc.SybDriver"); // jConnect 7 用 jdbc4 包
conn = DriverManager.getConnection(url, user, pwd);
stmt = conn.createStatement();
rs = stmt.executeQuery("SELECT name FROM users WHERE id=1");
if (rs.next()) {
// 驅動已正確解碼,直接使用
out.println("用戶名: " + rs.getString("name"));
}
} catch (Exception e) {
e.printStackTrace(out);
} finally {
if (rs != null) try { rs.close(); } catch (SQLException ignore) {}
if (stmt != null) try { stmt.close(); } catch (SQLException ignore) {}
if (conn != null) try { conn.close(); } catch (SQLException ignore) {}
}
%>
驗證清單
- ☑ Sybase 服務器字符集確認 (DBA/系統表)
- ☑ JDBC URL `charset=` 參數與服務器字符集**完全一致** (大小寫不敏感,建議小寫)
- ☑ `jconnect_version` 與驅動 jar 版本匹配 (jConnect 7 → `jdbc4` 包 + `jconnect_version=4`)
- ☑ JSP `pageEncoding="UTF-8"` `contentType="text/html;charset=UTF-8"`
- ☑ Tomcat `server.xml` `URIEncoding="UTF-8"` (防 URL 參數亂碼)
- ☑ **移除所有應用層手動 `getBytes("ISO-8859-1")` 轉碼代碼** — 它們是禍根
遺留專案無法修改 JDBC URL 的應急方案
若極端情況無法修改連線字串 (如第三方閉源組件),可嘗試在驅動載入前設定系統屬性 (僅對某些舊版驅動有效):
System.setProperty("sybase.charset", "eucgb"); // 必須在 Class.forName() 前
// 或
System.setProperty("jdbc.sybase.charset", "eucgb");
**但強烈建議修正連線 URL**,從源頭解決編碼問題。
copyright ©
萬盛學電腦網 all rights reserved