Rails 搭配 Oracle 字符集配置實戰指南

前言

在 Rails 開發環境中，預設配置多針對 MySQL 優化，但企業級專案常需對接 Oracle 資料庫。本文記錄實際專案中解決 Rails 2.0.2 版本下，搭配 Oracle 字符集配置的完整過程，特別針對中文顯示亂碼問題提供解決方案。

核心問題：中文顯示正常但資料庫客戶端亂碼

專案環境：Rails 應用伺服器、Oracle 客戶端皆為 ZHS16GBK，Oracle 伺服器為 AMERICAN_AMERICA.ZHS16GBK。雖然網頁端中文顯示正常，但使用 TOAD 或 Oracle 官方 Java 客戶端連線查看資料卻全是亂碼。這對後續資料匯出、遷移造成極大困擾。

字符集三要素解析

Oracle 字符集涉及三個層面：

• 作業系統/輸入顯示字符集：Rails 提交表單的編碼（UTF-8）及瀏覽器解碼編碼
• 客戶端字符集 (NLS_LANG)：告知資料庫傳入字符的編碼，以便轉換存儲
• 資料庫字符集：資料實際存儲的編碼格式（ZHS16GBK）

關鍵發現：客戶端字符集應匹配輸入端而非資料庫端

最初將客戶端 NLS_LANG 設為與資料庫一致的 ZHS16GBK，實現的是 UTF-8 數據的「透傳」——資料庫並未真正轉碼存儲。正確做法：將 Rails 應用伺服器的 Oracle 客戶端 NLS_LANG 設為 UTF8，讓資料庫識別輸入為 UTF-8，自動轉換為資料庫字符集 (ZHS16GBK) 存儲，讀取時再反向轉換。

環境變量配置最佳實踐

在 Windows 環境下，建議僅在啟動 Rails 前的命令列會話中設置：

set NLS_LANG=AMERICAN_AMERICA.UTF8

進階做法：將此命令加入 Rails 目錄下的 use_ruby.cmd，實現自動化。保持註冊表預設為 ZHS16GBK，確保 TOAD、SQL*Plus 等工具正常顯示。

總結

核心原則：客戶端字符集必須與應用輸入編碼一致。Rails 用 UTF-8 → 客戶端設 UTF8 → 資料庫自動轉換存儲為 ZHS16GBK → 讀取自動轉回 UTF-8。如此網頁、TOAD、官方客戶端三端同步正常，資料落地格式也符合資料庫規範。