VIP 結算異常說明

發生日期：2026-07-01 凌晨 00:00
影響範圍：24,668 位應降級玩家
修正完成時間：2026-07-01 15:00

一、問題描述

每季 VIP 等級結算時（每 3 個月一次），系統會檢查玩家的保級值是否達標：

• 達標 → 保級成功，維持原等級
• 未達標 → 降一級

本次結算中，應降級的玩家等級沒有正確降低，但經驗值被重置為降級後的數值。導致玩家看到的現象是：

• VIP 等級沒變（例如仍顯示 VIP6）
• 但經驗條顯示異常（經驗值已被設為 VIP5 的起點值）
• 結算獎勵按原等級（VIP6）發放，而非降級後等級（VIP5）

二、影響人數與處理結果

三、多發獎勵無法追回的損失

有 673 組玩家（586 人）在修正前已領取了錯誤等級的獎勵，這部分無法追回。淨損失如下：

已領取錯誤獎勵的等級分佈：

四、各等級降級人數

五、原因說明

系統在今年初從舊版環境（Python 2）升級到新版環境（Python 3）。程式碼本身沒有改動，但 Python 語言本身的底層行為在版本升級後有所不同。

具體來說，程式內部有一份「對照表」，用來把玩家資料存回資料庫。這份對照表裡有兩個名稱不同的欄位（"level" 和 "vipLevel"），但它們都指向資料庫中同一個位置。在降級時，程式只更新了 "level" 而沒有同步更新 "vipLevel"。

• Python 2：讀取對照表時順序是隨機的，恰好 "level"（正確的降級值）排在後面被寫入，覆蓋了 "vipLevel"（舊值），所以結果正確。
• Python 3：讀取對照表時保證按照建立順序，"vipLevel"（舊值）排在 "level" 後面被寫入，反而把正確的降級值覆蓋掉了。

簡單來說，同一段程式碼原本靠「運氣好」才正確運作，升級環境後運氣不再，潛藏的問題就暴露了。

技術細節（程式碼說明）

問題架構圖

對照表覆蓋問題

修正方式

對照表定義（PlayerTableData.py）：

PLAYER_WITH_STORE_DB_TABLE = {
    ...
    "level": "platformInfo.level",      # ← 第 72 行
    "vipLevel": "platformInfo.level",   # ← 第 73 行（指向同一個 DB 欄位）
    ...
}

"level" 和 "vipLevel" 都映射到資料庫的 platformInfo.level，寫入時後者會覆蓋前者。

降級程式碼（ResetSettingSystem.py）：

def _resetPlayer(self, player):
    ...
    player["level"] -= 1        # 降一級（例如 6 → 5）
    # 但 player["vipLevel"] 仍然是 6（沒有同步更新）
    ...
    self.server.playerSystem.updatePlayer(player)  # 寫入 DB

寫入 DB 時的行為差異：

updatePlayer 會遍歷對照表，把 player 的值轉換成 DB 格式寫入：

Python 2（dict 順序隨機）：
  → 可能先寫 vipLevel=6，再寫 level=5
  → DB 最終值 platformInfo.level = 5（正確）

Python 3（dict 保持插入順序）：
  → 一定先寫 level=5，再寫 vipLevel=6
  → DB 最終值 platformInfo.level = 6（錯誤，被舊值覆蓋）

修正方式：

player["level"] -= 1
player["vipLevel"] = player["level"]  # 加這行，同步更新

六、修正措施

1. 即時修正：已將所有受影響玩家的等級修正為正確的降級後等級
2. 獎勵修正：已刪除多發的獎勵信件，並重新發送正確等級的獎勵
3. 補發信件修正：補發信件初始設定了錯誤的領取模式（recvMode），導致玩家看到信件但無法領取扭蛋幣，已修正為正確模式
4. 已讀未入帳修正：29 位玩家在修正前已點擊領取但道具未入帳，已將信件重置為未領取狀態，玩家可重新領取
5. 已領取多發獎勵的玩家：313 組玩家已領取原等級獎勵且無法追回，不再重複補發
6. 保級獎勵誤刪補發：刪除多發信件時條件以 playerNum 為單位，導致同一玩家在其他店家的「保級獎勵」也被連帶刪除。已比對備份機資料確認缺失清單，補發 1,754 封保級獎勵信（678 組玩家+店家）
7. 程式修正：已修正程式碼，下次結算（2026-10-01）不會再發生此問題

七、保級獎勵誤刪補發明細

原因：同一位玩家可能在 A 店降級、B 店保級。刪除多發信件時以 playerNum 過濾，連帶把 B 店的正確保級獎勵也刪除了。

補發等級分佈：

補發道具總量：

八、相關檔案