微信小程序页面迁移校验之前 P5任务处理之前

apps/etl/connectors/feiqiu/database/connection.py

@@ -20,7 +20,15 @@ class DatabaseConnection:
         # 生产环境要求：数据库连接超时不得超过 20 秒。
         timeout_val = max(1, min(int(timeout_val), 20))
 
-        conn = psycopg2.connect(self._dsn, connect_timeout=timeout_val)
+        # CHANGE 2026-03-06 | intent: 修复 Windows GBK 环境下 psycopg2 连接握手的 UnicodeDecodeError
+        # assumptions: libpq 默认使用系统 locale 的 client_encoding，Windows 中文系统为 GBK/CP936
+        # 边界: 显式指定 client_encoding=utf8 确保连接层始终使用 UTF-8，与数据库 server_encoding 一致
+        # 验证: web-admin 手动触发 ETL 全量 flow，不再出现 0xd6 解码错误
+        conn = psycopg2.connect(
+            self._dsn,
+            connect_timeout=timeout_val,
+            options="-c client_encoding=utf8",
+        )
         conn.autocommit = False
 
         # 会话参数（时区、语句超时等）