sycommon-python-lib 0.2.7a46__tar.gz → 0.2.7a48__tar.gz

{sycommon_python_lib-0.2.7a46 → sycommon_python_lib-0.2.7a48}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sycommon-python-lib
-Version: 0.2.7a46
+Version: 0.2.7a48
 Summary: Add your description here
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown

{sycommon_python_lib-0.2.7a46 → sycommon_python_lib-0.2.7a48}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sycommon-python-lib"
-version = "0.2.7a46"
+version = "0.2.7a48"
 description = "Add your description here"
 readme = "README.md"
 requires-python = ">=3.11"

sycommon_python_lib-0.2.7a48/src/sycommon/agent/middleware/sitecustomize.py

@@ -0,0 +1,300 @@
+"""技能接口白名单客户端注入脚本（部署到沙箱 site-packages）。
+
+Python 解释器启动时（未传 -S）自动 import 本模块。它负责 Python HTTP 库的
+请求拦截：
+
+  1. 读环境变量 SKILL_API_WHITELIST（JSON）。无此 env → 不管控（全放行，fail-open）。
+  2. monkeypatch urllib / httpx / requests / aiohttp，发请求前做 path 级前缀匹配，
+     未命中抛 PermissionError（LLM 能看到清晰错误）。
+
+  ⚠️ shell 命令（curl/wget 等）的拦截【不】在本文件处理——sitecustomize 只在
+     `python` 启动时执行，纯 shell 命令不会触发它。shell 拦截由主进程中间件把
+     curl/wget 包装函数【内联】到每条 execute 命令前缀实现（见 skill_api_whitelist.py）。
+
+URL 匹配核心逻辑复用同目录 skill_wl_check.py。
+
+另外提供【独立于白名单】的 header 注入：当环境变量 SYT_API_AUTHZ 非空时，
+对 host 命中 SYT_BASE_URL 的请求自动补 X-Sy-Api-Authz 头。这是云平台网关的
+鉴权要求，对所有沙箱技能请求生效（不门控白名单），由中间件无条件 export
+SYT_API_AUTHZ + 推送本 sitecustomize 触发。
+
+注意：本模块在沙箱子进程里运行，不依赖主进程内存。配置全部来自环境变量。
+"""
+
+import json
+import os
+import sys
+from urllib.parse import urlparse
+
+# SKILL_API_WHITELIST 存在即「启用管控」；allowlist 为空时「全拦截」。
+_ENABLED = "SKILL_API_WHITELIST" in os.environ
+
+# 把沙箱 site-packages 里存放本模块的目录加入 sys.path，以便 import skill_wl_check。
+_HERE = os.path.dirname(os.path.abspath(__file__))
+if _HERE not in sys.path:
+    sys.path.insert(0, _HERE)
+
+
+def _load_check():
+    """加载同目录 skill_wl_check，返回其 match 函数；失败返回 None。"""
+    try:
+        import skill_wl_check  # type: ignore
+        return skill_wl_check
+    except Exception as e:  # pragma: no cover
+        sys.stderr.write("[sitecustomize] 加载 skill_wl_check 失败，白名单禁用: %s\n" % e)
+        return None
+
+
+def _patch_urllib(match):
+    import urllib.request
+
+    _orig = urllib.request.urlopen
+
+    def _urlopen(url, *args, **kwargs):
+        actual = url.full_url if isinstance(url, urllib.request.Request) else url
+        if actual and not match(str(actual)):
+            raise PermissionError(
+                "[SkillApiWhitelist] 拦截: URL 不在白名单内 (urlopen, %s)" % actual)
+        return _orig(url, *args, **kwargs)
+
+    urllib.request.urlopen = _urlopen
+
+
+def _patch_httpx(match):
+    try:
+        import httpx
+    except ImportError:
+        return
+
+    _orig_sync = httpx.Client.send
+
+    def _send(self, request, **kwargs):
+        if not match(str(request.url)):
+            raise PermissionError(
+                "[SkillApiWhitelist] 拦截: URL 不在白名单内 (httpx, %s)" % request.url)
+        return _orig_sync(self, request, **kwargs)
+
+    httpx.Client.send = _send
+
+    if hasattr(httpx, "AsyncClient"):
+        _orig_async = httpx.AsyncClient.send
+
+        async def _asend(self, request, **kwargs):
+            if not match(str(request.url)):
+                raise PermissionError(
+                    "[SkillApiWhitelist] 拦截: URL 不在白名单内 (httpx.async, %s)" % request.url)
+            return await _orig_async(self, request, **kwargs)
+
+        httpx.AsyncClient.send = _asend
+
+
+def _patch_requests(match):
+    try:
+        import requests
+    except ImportError:
+        return
+
+    _orig = requests.Session.request
+
+    def _request(self, method, url, *args, **kwargs):
+        if not match(str(url)):
+            raise PermissionError(
+                "[SkillApiWhitelist] 拦截: URL 不在白名单内 (requests %s, %s)"
+                % (method.upper(), url))
+        return _orig(self, method, url, *args, **kwargs)
+
+    requests.Session.request = _request
+
+
+def _patch_aiohttp(match):
+    try:
+        import aiohttp
+    except ImportError:
+        return
+    if not hasattr(aiohttp.ClientSession, "_request"):
+        return
+
+    _orig = aiohttp.ClientSession._request
+
+    async def _request(self, method, str_or_url, **kwargs):
+        if not match(str(str_or_url)):
+            raise PermissionError(
+                "[SkillApiWhitelist] 拦截: URL 不在白名单内 (aiohttp %s, %s)"
+                % (method, str_or_url))
+        return await _orig(self, method, str_or_url, **kwargs)
+
+    aiohttp.ClientSession._request = _request
+
+
+# =============== header 注入（独立于白名单）===============
+# 云平台网关要求请求带 X-Sy-Api-Authz 头。仅当 host 命中 SYT_BASE_URL 的 host
+# 才补该头，其它域名（内网 OCR / 企微 / 合同比对内网 / MCP 后端等）不注入。
+# 门控：环境变量 SYT_API_AUTHZ 非空。调用方已显式设过同名头则不覆盖。
+
+_AUTHZ_HEADER = "X-Sy-Api-Authz"
+
+
+def _syt_host():
+    """解析 SYT_BASE_URL 的 host（小写）。失败返回 None。"""
+    base = os.environ.get("SYT_BASE_URL", "").strip()
+    if not base:
+        return None
+    try:
+        return (urlparse(base).hostname or "").lower() or None
+    except Exception:
+        return None
+
+
+def _host_matches_syt(url) -> bool:
+    """请求 URL 的 host 是否等于 SYT_BASE_URL 的 host。"""
+    host = _syt_host()
+    if not host:
+        return False
+    try:
+        return (urlparse(str(url)).hostname or "").lower() == host
+    except Exception:
+        return False
+
+
+def _patch_urllib_hdr():
+    import urllib.request
+
+    _orig = urllib.request.urlopen
+
+    def _urlopen(url, *args, **kwargs):
+        # 只能给 Request 对象补头；裸 str URL 在 urlopen 层无 headers 概念，跳过
+        if isinstance(url, urllib.request.Request) and _host_matches_syt(url.full_url):
+            url.add_header(_AUTHZ_HEADER, os.environ["SYT_API_AUTHZ"])
+        return _orig(url, *args, **kwargs)
+
+    urllib.request.urlopen = _urlopen
+
+
+def _patch_requests_hdr():
+    try:
+        import requests
+    except ImportError:
+        return
+
+    _orig = requests.Session.request
+
+    def _request(self, method, url, *args, **kwargs):
+        if _host_matches_syt(url):
+            headers = kwargs.get("headers")
+            if headers is None:
+                headers = {}
+            if isinstance(headers, dict):
+                if _AUTHZ_HEADER not in headers:
+                    headers[_AUTHZ_HEADER] = os.environ["SYT_API_AUTHZ"]
+                kwargs["headers"] = headers
+            else:
+                # list / 其它形态：保守起见交给底层，避免破坏既有结构
+                pass
+        return _orig(self, method, url, *args, **kwargs)
+
+    requests.Session.request = _request
+
+
+def _patch_httpx_hdr():
+    try:
+        import httpx
+    except ImportError:
+        return
+
+    def _apply(request):
+        if request is not None and _host_matches_syt(request.url):
+            request.headers.setdefault(_AUTHZ_HEADER, os.environ["SYT_API_AUTHZ"])
+
+    _orig_sync = httpx.Client.send
+
+    def _send(self, request, **kwargs):
+        _apply(request)
+        return _orig_sync(self, request, **kwargs)
+
+    httpx.Client.send = _send
+
+    if hasattr(httpx, "AsyncClient"):
+        _orig_async = httpx.AsyncClient.send
+
+        async def _asend(self, request, **kwargs):
+            _apply(request)
+            return await _orig_async(self, request, **kwargs)
+
+        httpx.AsyncClient.send = _asend
+
+
+def _patch_aiohttp_hdr():
+    try:
+        import aiohttp
+    except ImportError:
+        return
+    if not hasattr(aiohttp.ClientSession, "_request"):
+        return
+
+    _orig = aiohttp.ClientSession._request
+
+    async def _request(self, method, str_or_url, **kwargs):
+        if _host_matches_syt(str_or_url):
+            headers = kwargs.get("headers")
+            if isinstance(headers, dict):
+                if _AUTHZ_HEADER not in headers:
+                    headers[_AUTHZ_HEADER] = os.environ["SYT_API_AUTHZ"]
+            elif headers is None:
+                kwargs["headers"] = {_AUTHZ_HEADER: os.environ["SYT_API_AUTHZ"]}
+            else:
+                # list / CIMultiDict 等其它形态：跳过，避免破坏结构
+                pass
+        return await _orig(self, method, str_or_url, **kwargs)
+
+    aiohttp.ClientSession._request = _request
+
+
+def _install_header_injection():
+    """装 header 注入 patch（独立于白名单）。
+
+    门控：环境变量 SYT_API_AUTHZ 非空。任一库 import 失败都不阻断。
+    """
+    val = os.environ.get("SYT_API_AUTHZ", "").strip()
+    if not val:
+        return
+    if not _syt_host():
+        sys.stderr.write(
+            "[sitecustomize] SYT_API_AUTHZ 已设置但 SYT_BASE_URL 无法解析 host，"
+            "跳过 header 注入\n")
+        return
+    _patch_urllib_hdr()
+    _patch_requests_hdr()
+    _patch_httpx_hdr()
+    _patch_aiohttp_hdr()
+
+
+def _install():
+    if not _ENABLED:
+        return
+    check = _load_check()
+    if check is None:
+        return
+    # allowlist 为空（明确禁止）时也走校验——match 必然 False，从而全拦截。
+    match = check.match
+    _patch_urllib(match)
+    _patch_httpx(match)
+    _patch_requests(match)
+    _patch_aiohttp(match)
+
+
+# 保留解析结果（供排查）
+try:
+    _WHITELIST_RAW = json.loads(os.environ.get("SKILL_API_WHITELIST", "{}"))
+except Exception:
+    _WHITELIST_RAW = {}
+
+try:
+    _install()
+except Exception as _e:  # 任何 patch 失败都不能阻断进程启动
+    sys.stderr.write("[sitecustomize] 白名单安装失败（fail-open）: %s\n" % _e)
+
+# header 注入独立于白名单，单独 try/except，互不影响
+try:
+    _install_header_injection()
+except Exception as _e:
+    sys.stderr.write("[sitecustomize] header 注入安装失败（fail-open）: %s\n" % _e)

{sycommon_python_lib-0.2.7a46 → sycommon_python_lib-0.2.7a48}/src/sycommon/agent/middleware/skill_api_whitelist.py

@@ -26,6 +26,7 @@ import os
 import re
 import shlex
 from typing import Optional
+from urllib.parse import urlparse
 
 from langchain.agents.middleware.types import AgentMiddleware
 from langchain_core.messages import ToolMessage
@@ -35,12 +36,17 @@ from sycommon.logging.kafka_log import SYLogger
 
 # 命令路径形如  skills/system/sy-oa-skill/workflow-todo/scripts/x.py
 #               skills/user/sy-oa-skill/SKILL.md
-# 拆为 system/user/shengye-platform 多层后,顶层段是 system|user|shengye-platform,
-# 需跳过它取【第二段】作域级技能名(如 sy-oa-skill / oa),配合 SkillApiWhitelist
-# 按顶级域配置。(?<![\w]) 否定左查找:要求 skills 前不是单词字符,避免误匹配 myskills/。
+# _SKILL_TOP_RE：白名单配置提取用——限定 system|user|shengye-platform 三层后取第二段
+# 作域级技能名(如 sy-oa-skill / oa)，配合 SkillApiWhitelist 按顶级域配置。
+# (?<![\w]) 否定左查找:要求 skills 前不是单词字符,避免误匹配 myskills/。
 _SKILL_TOP_RE = re.compile(
     r'(?<![\w])skills/(?:system|user|shengye-platform)/([A-Za-z0-9_\-]+)(?:/|$)')
 
+# _SKILL_ANY_RE：技能命令判定用（宽松）——匹配任意 skills/<...>/ 前缀。
+# 用于 header 注入等对所有技能命令（含用户自行拷贝到非 system 目录的技能）生效的能力，
+# 与白名单配置是否启用解耦。同样 (?<![\w]) 避免误匹配 myskills/。
+_SKILL_ANY_RE = re.compile(r'(?<![\w])skills/[A-Za-z0-9_\-]+(?:/|$)')
+
 # BASE_URL 占位符 ${VAR}
 _PLACEHOLDER_RE = re.compile(r'\$\{([A-Z_][A-Z0-9_]*)\}')
 
@@ -167,26 +173,51 @@ def _load_resource_bytes(filename: str) -> bytes:
             f"读取注入脚本 {filename} 失败，请确认已随包安装(package_data): {e}") from e
 
 
-def _build_shell_guard() -> str:
+def _build_shell_guard(with_whitelist: bool = False,
+                       with_header: bool = False) -> str:
     """生成内联到命令前缀的 curl/wget 包装函数（shell）。
 
-    在 SKILL_API_WHITELIST 已 export 的命令里生效：调用 curl/wget 前先抽取
-    参数里首个 http(s) URL，用沙箱 python3 调 skill_wl_check.match 校验，
-    未命中则 return 1 拦截。skill_wl_check 与 sitecustomize 同处 site-packages，
-    python3 启动时 sitecustomize 会 import 它并把该目录加入 sys.path。
+    抽取参数里【最后一个】 http(s) URL 到 _u，按需承担两类职责（可同时启用，
+    先白名单校验、再注入 header）：
+      - with_whitelist：用沙箱 python3 调 skill_wl_check.match 校验 _u，未命中 return 1。
+      - with_header：_u 的 host 命中 $__SYT_HOST__ 时追加 -H "X-Sy-Api-Authz:
+        $SYT_API_AUTHZ"（原参数已含同名头则不重复加）。
 
-    覆盖 curl / wget；其它 shell 出网方式(nc/裸 /dev/tcp 等)不覆盖。
+    skill_wl_check 与 sitecustomize 同处 site-packages，python3 启动时 sitecustomize
+    会 import 它并把该目录加入 sys.path。覆盖 curl / wget；其它 shell 出网方式
+    (nc/裸 /dev/tcp 等)不覆盖。
     """
-    check_cmd = (
-        'python3 -c \'import skill_wl_check,sys; '
-        'sys.exit(0 if skill_wl_check.match(sys.argv[1]) else 1)\' "$_u"'
-    )
-    # 单个命令的函数体模板：抽取 URL → 校验 → 通过则 command <CMD> "$@"
+    wl_block = ""
+    if with_whitelist:
+        check_cmd = (
+            'python3 -c \'import skill_wl_check,sys; '
+            'sys.exit(0 if skill_wl_check.match(sys.argv[1]) else 1)\' "$_u"'
+        )
+        wl_block = (
+            f'if [ -n "$_u" ] && ! {check_cmd}; then '
+            'echo "[SkillApiWhitelist] 拦截 shell 请求: $_u" 1>&2; return 1; fi; '
+        )
+    hdr_block = ""
+    if with_header:
+        # 从 _u 取 host（小写）：剥 scheme/path/query/fragment/userinfo/port
+        hdr_block = (
+            'if [ -n "$_u" ] && [ -n "$__SYT_HOST__" ] && [ -n "$SYT_API_AUTHZ" ]; then '
+            '_h="${_u#*://}"; _h="${_h%%/*}"; _h="${_h%%\\?*}"; _h="${_h%%#*}"; '
+            '_h="${_h##*@}"; _h="${_h%%:*}"; '
+            'case "$(printf "%s" "$_h" | tr "A-Z" "a-z")" in '
+            '"$__SYT_HOST__") '
+            'case " $* " in *"X-Sy-Api-Authz"*) :;; *) '
+            'set -- "$@" -H "X-Sy-Api-Authz: $SYT_API_AUTHZ";; '
+            'esac;; '
+            'esac; '
+            'fi; '
+        )
+    if not wl_block and not hdr_block:
+        return ""
     body = (
-        '() { local _u; for _a in "$@"; do '
+        '() { local _u _a _h; for _a in "$@"; do '
         'case "$_a" in http://*|https://*) _u="$_a";; esac; done; '
-        f'if [ -n "$_u" ] && ! {check_cmd}; then '
-        'echo "[SkillApiWhitelist] 拦截 shell 请求: $_u" 1>&2; return 1; fi; '
+        + wl_block + hdr_block +
         'command {CMD} "$@"; };'
     )
     guard = "curl" + body.replace("{CMD}", "curl") + " wget" + body.replace("{CMD}", "wget")
@@ -329,42 +360,69 @@ class SkillApiWhitelistMiddleware(AgentMiddleware):
         if not command:
             return await handler(request)
 
-        skill_name = self._extract_skill_name(command)
-        if skill_name is None:
-            # 非技能命令（无 skills/<顶级技能>/）→ 不管控
+        # 技能命令判定（宽松）：任意 skills/.../ 前缀即算（含用户拷贝到非 system
+        # 目录的技能）。header 注入等对所有技能命令生效的能力以此为门控。
+        if not _SKILL_ANY_RE.search(command):
+            # 非技能命令 → 不注入任何前缀
             return await handler(request)
 
-        # 延迟导入避免模块加载期循环依赖
+        # 白名单配置提取（限定三层后取第二段）
+        skill_name = self._extract_skill_name(command)
         from sycommon.config.SkillApiWhitelistConfig import SkillApiWhitelistConfig
-        cfg = SkillApiWhitelistConfig.from_config(skill_name)
-        if cfg is None or not cfg.enabled:
-            # 未配置 / 禁用 → 全放行（向后兼容）
-            return await handler(request)
+        cfg = (SkillApiWhitelistConfig.from_config(skill_name)
+               if skill_name is not None else None)
+        whitelist_on = bool(cfg and cfg.enabled)
 
         # 主进程解析占位符 ${VAR}（数据源：os.environ + sandbox env 字典）
         env_lookup = self._env_lookup()
         resolved = []
-        for pat in cfg.allowlist:
-            if "${" in pat:
-                expanded = _resolve_placeholders(pat, env_lookup)
-                if expanded:
-                    resolved.append(expanded)
-            else:
-                resolved.append(pat)
-
-        # 推送注入脚本（惰性，每后端实例一次）
-        await self._ensure_sitecustomize()
-
-        # 序列化白名单 + PYTHONPATH(shell 启动 python 时自动 import sitecustomize)
-        # + shell guard(curl/wget 拦截) + export SKILL_API_WHITELIST
-        payload = json.dumps({"skill": skill_name, "allowlist": resolved},
-                             ensure_ascii=False)
-        guard = _build_shell_guard()
-        prefix_parts = [
-            f"export SKILL_API_WHITELIST={shlex.quote(payload)}",
-            f'export PYTHONPATH="{_WL_DIR}:$PYTHONPATH"',
-            guard,
-        ]
+        if whitelist_on:
+            for pat in cfg.allowlist:
+                if "${" in pat:
+                    expanded = _resolve_placeholders(pat, env_lookup)
+                    if expanded:
+                        resolved.append(expanded)
+                else:
+                    resolved.append(pat)
+
+        # header 注入所需：SYT_API_AUTHZ（缺则不注入）+ SYT_BASE_URL 的 host
+        syt_authz = env_lookup("SYT_API_AUTHZ")
+        header_on = bool(syt_authz and syt_authz.strip())
+        syt_host = ""
+        if header_on:
+            syt_base = env_lookup("SYT_BASE_URL") or ""
+            try:
+                syt_host = (urlparse(syt_base).hostname or "").lower()
+            except Exception:
+                syt_host = ""
+            header_on = bool(syt_host)
+
+        # 推送注入脚本（惰性，每后端实例一次）。
+        # 只要【白名单 或 header 注入】任一启用就要推 .wl（sitecustomize）。
+        if whitelist_on or header_on:
+            await self._ensure_sitecustomize()
+
+        # 组装命令前缀
+        prefix_parts: list[str] = []
+        if whitelist_on:
+            payload = json.dumps({"skill": skill_name, "allowlist": resolved},
+                                 ensure_ascii=False)
+            prefix_parts.append(f"export SKILL_API_WHITELIST={shlex.quote(payload)}")
+        if header_on:
+            prefix_parts.append(
+                f"export SYT_API_AUTHZ={shlex.quote(syt_authz)}")
+            prefix_parts.append(f'export __SYT_HOST__={shlex.quote(syt_host)}')
+        if whitelist_on or header_on:
+            # PYTHONPATH(shell 启动 python 时自动 import sitecustomize)
+            prefix_parts.append(f'export PYTHONPATH="{_WL_DIR}:$PYTHONPATH"')
+            guard = _build_shell_guard(with_whitelist=whitelist_on,
+                                       with_header=header_on)
+            if guard:
+                prefix_parts.append(guard)
+
+        if not prefix_parts:
+            return await handler(request)
+
         # 每个 part 之间用 '; ' 分隔（而非空格）—— export 语句之间、函数定义与后续命令
         # 之间都需要语句分隔符；末尾留一个 ';' 与原命令隔开。
         prefix = "; ".join(prefix_parts) + "; "
@@ -372,5 +430,11 @@ class SkillApiWhitelistMiddleware(AgentMiddleware):
         new_command = prefix + command
         new_args = {**args, "command": new_command} if isinstance(args, dict) else args
         new_tc = {**tc, "args": new_args}
-        SYLogger.info("[Whitelist] 注入子技能 %s 白名单(%d 条)", skill_name, len(resolved))
+        tags = []
+        if whitelist_on:
+            tags.append(f"白名单({len(resolved)}条)")
+        if header_on:
+            tags.append("Authz头注入")
+        SYLogger.info("[Whitelist] 技能 %s 注入: %s", skill_name or "<user>",
+                      "+".join(tags) if tags else "(空)")
         return await handler(request.override(tool_call=new_tc))

{sycommon_python_lib-0.2.7a46 → sycommon_python_lib-0.2.7a48}/src/sycommon/auth/ldap_service.py

@@ -126,7 +126,9 @@ class LDAPAuthService:
         user_dn = self._build_user_dn(username)
 
         # 尝试连接各个 LDAP 服务器
-        last_error = None
+        # 优先返回认证类错误（invalidCredentials 等），而非连接类错误（timeout）。
+        # 避免备用服务器连接超时覆盖了主服务器的真实认证错误（密码错误），误导用户。
+        errors = []
         for url in self.config.urls:
             try:
                 # 创建连接（移除末尾的斜杠，设置连接超时）
@@ -155,15 +157,32 @@ class LDAPAuthService:
                 )
 
             except LDAPException as e:
-                last_error = e
+                errors.append((url, str(e)))
                 SYLogger.warning(f"[LDAP] 连接 {url} 失败: {e}")
                 continue
 
-        SYLogger.error(f"[LDAP] 用户 {username} 认证失败: {last_error}")
-        return LDAPAuthResult(
-            success=False,
-            error=f"认证失败: {last_error}" if last_error else "认证失败",
-        )
+        # 优先返回认证类错误（密码错误等），而不是连接超时
+        # 按优先级排序：invalidCredentials / invalidAttribute / insufficientAccess 优先
+        auth_keywords = ["invalidcredentials", "invalidattribute", "insufficientaccess", "密码", "credential"]
+        for url, err in errors:
+            if any(kw in err.lower() for kw in auth_keywords):
+                SYLogger.error(f"[LDAP] 用户 {username} 认证失败: {err}")
+                return LDAPAuthResult(
+                    success=False,
+                    error=f"认证失败: {err}",
+                )
+
+        # 全是连接类错误，返回第一个（通常是主服务器）
+        if errors:
+            first_err = errors[0][1]
+            SYLogger.error(f"[LDAP] 用户 {username} 认证失败: {first_err}")
+            return LDAPAuthResult(
+                success=False,
+                error=f"认证失败: {first_err}",
+            )
+
+        SYLogger.error(f"[LDAP] 用户 {username} 认证失败: 未知错误")
+        return LDAPAuthResult(success=False, error="认证失败: 未知错误")
 
     def _build_user_dn(self, username: str) -> str:
         """构建用户 DN