Tigase XMPP 服務器數據庫結構解析：tig_users、tig_nodes、tig_pairs 三大核心表

Tigase XMPP 服務器數據庫結構解析：tig_users、tig_nodes、tig_pairs 三大核心表

Tigase 是基於 XMPP 協議的開源即時通訊服務器，其數據庫設計採用極度泛化的實體-屬性-值（EAV）模型。本文解析三大核心表結構、層次關系、XML 數據存儲格式，並說明 roster、離線消息、隱私列表等業務映射邏輯。

核心表結構

1. tig_users：用戶主表

CREATE TABLE `tig_users` (
    `uid` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY,
    `user_id` VARCHAR(255) NOT NULL,      -- 用戶名（JID 本地部分）
    `user_pw` VARCHAR(255) NOT NULL,      -- 密碼雜湊
    `last_login` BIGINT DEFAULT 0,
    `last_logout` BIGINT DEFAULT 0,
    `online_status` INT DEFAULT 0,
    UNIQUE KEY `uk_user_id` (`user_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

2. tig_nodes：節點樹（層次結構）

CREATE TABLE `tig_nodes` (
    `nid` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY,
    `parent_nid` BIGINT UNSIGNED DEFAULT 0,  -- 父節點
    `uid` BIGINT UNSIGNED NOT NULL,          -- 歸屬用戶
    `node` VARCHAR(255) NOT NULL,            -- 節點類型
    `key` VARCHAR(255) DEFAULT NULL,         -- 可選鍵
    KEY `idx_uid` (`uid`),
    KEY `idx_parent_nid` (`parent_nid`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

每個用戶（uid）固定擁有 5 個根節點：

• root：根節點，掛載 roster
• privacy：隱私列表父節點
• offline：離線消息父節點
• invisible：隱身狀態節點
• msgoffline：離線消息存儲節點（掛在 offline 下）

層次關系：

root
└─ privacy
   └─ invisible
└─ offline
   └─ msgoffline

3. tig_pairs：屬性值存儲（EAV 模型核心）

CREATE TABLE `tig_pairs` (
    `uid` BIGINT UNSIGNED NOT NULL,
    `nid` BIGINT UNSIGNED NOT NULL,
    `pkey` VARCHAR(255) NOT NULL,
    `pval` LONGTEXT,                          -- XML 格式存儲
    PRIMARY KEY (`uid`, `nid`, `pkey`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

關鍵行示例（uid=14）：

業務查詢示例

-- 獲取用戶 roster
SELECT pval FROM tig_pairs
WHERE uid = (SELECT uid FROM tig_users WHERE user_id = 'user1')
  AND pkey = 'roster';

-- 獲取離線消息
SELECT pval FROM tig_pairs
WHERE uid = 14 AND pkey = 'messages'
ORDER BY nid;  -- 按存儲順序

設計特點與權衡

參考資源

• 官方文檔：Tigase DB Schema Explained
• 源碼：tigase-db/src/main/java/tigase/db/