【对话 · 运行时 · 正常】
用户发问
  → docker-api-1  POST /agent/<id>/chat-messages
  → 快照 tools.dify_tools[]
       provider_type = "api"
       provider_id   = 021a4445-...   （tool_api_providers 表 UUID）
  → ToolManager.get_api_provider_controller(tenant_id, UUID)
  → GET http://192.168.110.207:8777/server/status?...
  → 第二次 LLM 格式化回答

【配置页 · 会 500】
浏览器打开「配置」
  → 前端按「内置插件」去拉凭据
  → GET /console/api/workspaces/current/tool-provider/builtin/<provider_id>/credential/info
       这里的 <provider_id> 被填成了上面那个 UUID
  → ToolManager.get_builtin_provider(UUID, tenant_id)
  → plugin_daemon：PluginNotFoundError: plugin not found
  → 接口 HTTP 500
  → 页面 toast「Internal Server Error」

Exception on /console/api/workspaces/current/tool-provider/builtin/021a4445-098d-4821-81fe-ff0ebc660ecc/credential/info [GET]
core.plugin.impl.exc.PluginNotFoundError: plugin not found

invalid input syntax for type uuid: "server_status"

curl -s -m 10 -H 'Authorization: Bearer 123456' http://116.62.10.183:8000/v1/models
curl -s 'http://127.0.0.1:8777/health'
curl -s 'http://127.0.0.1:8777/server/status?server_name=gpu-server-01'

/usr/bin/python3 /opt/workbuddy/scripts_cursor/Dify_专题十六_新Agent配置页InternalServerError/专题十六_01_复现与定位.py

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""专题十六 · 步骤 1：复现并定位「打开 Agent 配置页 Internal Server Error」。

对照三项：
1) 对话仍能调 OpenAPI 工具（streaming 200）
2) 配置页接口 builtin/<UUID>/credential/info 是否 500
3) API 日志是否 PluginNotFoundError
"""
from __future__ import annotations

import sys

import _bootstrap  # noqa: F401
import _config as C
from dify_api import Dify, pp


def main() -> int:
    d = Dify(C.DIFY_EMAIL, C.DIFY_PASSWORD)
    try:
        d.login()
        uuid = C.SERVER_STATUS_PROVIDER_ID
        print("provider UUID", uuid)

        r_api = d.get(
            "/workspaces/current/tool-provider/api/get?provider=%s" % C.SERVER_STATUS_PROVIDER
        )
        pp("1) OpenAPI provider 详情", r_api, limit=400)

        r_bad = d.get(
            "/workspaces/current/tool-provider/builtin/%s/credential/info" % uuid
        )
        pp("2) 配置页误打的 builtin credential/info", r_bad, limit=500)

        r_ok = d.get("/workspaces/current/tool-provider/builtin/time/credential/info")
        pp("3) 真正的 builtin（time）对照", r_ok, limit=300)

        r_chat = d.post(
            "/agent/%s/chat-messages" % C.HOMEWORK1_AGENT_ID,
            body={
                "inputs": {},
                "query": C.HOMEWORK1_PROBE_QUERY,
                "response_mode": "streaming",
                "files": [],
                "conversation_id": "",
            },
            extra="-m 120 --max-time 120",
            t=150,
        )
        text = r_chat.get("text") or ""
        print("\n4) 对话 HTTP", r_chat.get("code"), "getServerStatus" in text, "45%" in text)

        out, _ = d.sh(
            "docker logs %s --tail 40 2>&1 | grep -iE 'PluginNotFound|credential/info' | tail -10"
            % C.DIFY_API_CTR
        )
        print("\n5) api 日志片段:\n", out or "(无匹配，可能已打补丁)")

        code = r_bad.get("code")
        if code == "500":
            print("\n[定位完成] 配置页接口 500 = 本专题场景。下一步跑作业1_06。")
            return 0
        if code == "200":
            print("\n[已修复] credential/info 已是 200，配置页应不再红条。请 Ctrl+F5。")
            return 0
        print("\n[异常] 预期 500 或 200，实际 HTTP", code)
        return 1
    finally:
        d.close()


if __name__ == "__main__":
    sys.exit(main())

bash /opt/workbuddy/scripts_bash_cursor/Dify_专题十六_新Agent配置页InternalServerError/专题十六_02_查日志与补丁.sh

#!/usr/bin/env bash
# 专题十六 · 在 207 上确认配置页误打的 builtin 接口
set -euo pipefail

UUID="${1:-021a4445-098d-4821-81fe-ff0ebc660ecc}"

echo "=== docker-api-1 最近 PluginNotFound ==="
docker logs docker-api-1 --tail 80 2>&1 | grep -iE "PluginNotFound|credential/info" | tail -15 || true

echo
echo "=== 容器内文件是否已有兜底 ==="
docker exec docker-api-1 grep -n "skip builtin credential/info for non-plugin provider" \
  /app/api/services/tools/builtin_tools_manage_service.py || echo "(尚未打补丁)"

/usr/bin/python3 /opt/workbuddy/scripts_cursor/Dify_专题十六_新Agent配置页InternalServerError/作业1_06_修复配置页InternalServerError.py

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""作业 1 · 修复打开 Agent 配置页 Internal Server Error（精确打到 credential/info）。"""
from __future__ import annotations

import sys

import _bootstrap  # noqa: F401
import _config as C
from dify_api import Dify

REMOTE = "/app/api/services/tools/builtin_tools_manage_service.py"

OLD = '''    def get_builtin_tool_provider_credential_info(
        tenant_id: str,
        provider: str,
        session: Session,
        user: Account | None = None,
        include_credential_ids: list[str] | None = None,
    ) -> ToolProviderCredentialInfoApiEntity:
        """
        get builtin tool provider credential info
        """
        provider_controller = ToolManager.get_builtin_provider(provider, tenant_id)
'''

NEW = '''    def get_builtin_tool_provider_credential_info(
        tenant_id: str,
        provider: str,
        session: Session,
        user: Account | None = None,
        include_credential_ids: list[str] | None = None,
    ) -> ToolProviderCredentialInfoApiEntity:
        """
        get builtin tool provider credential info
        """
        try:
            provider_controller = ToolManager.get_builtin_provider(provider, tenant_id)
        except Exception as exc:
            err = str(exc).lower()
            if type(exc).__name__ in (
                "PluginNotFoundError",
                "ToolProviderNotFoundError",
            ) or "plugin not found" in err:
                logger.warning(
                    "skip builtin credential/info for non-plugin provider %s: %s",
                    provider,
                    exc,
                )
                return ToolProviderCredentialInfoApiEntity(
                    supported_credential_types=[],
                    is_oauth_custom_client_enabled=False,
                    credentials=[],
                )
            raise
'''


def main() -> int:
    d = Dify(C.DIFY_EMAIL, C.DIFY_PASSWORD)
    try:
        d.login()
        img, _ = d.sh(
            "docker inspect %s --format '{{.Config.Image}}'" % C.DIFY_API_CTR
        )
        image = img.strip()
        print("image", image)

        # 从镜像恢复原文件（上次误改了 list_builtin_tool_provider_tools）
        d.sh(
            "docker run --rm --entrypoint cat %s %s > /tmp/builtin_tools_orig.py"
            % (image, REMOTE)
        )
        orig, _ = d.sh("wc -l /tmp/builtin_tools_orig.py; grep -c get_builtin_tool_provider_credential_info /tmp/builtin_tools_orig.py")
        print("orig", orig)

        d.sh("docker cp /tmp/builtin_tools_orig.py %s:%s" % (C.DIFY_API_CTR, REMOTE))
        content, _ = d.sh("docker exec %s cat %s" % (C.DIFY_API_CTR, REMOTE))
        if OLD not in content:
            print("恢复后仍找不到精确插入点")
            print("has func", "get_builtin_tool_provider_credential_info" in content)
            return 1
        if "skip builtin credential/info for non-plugin provider" in content.split("get_builtin_tool_provider_credential_info", 1)[-1][:800]:
            print("目标函数已有补丁")
        else:
            patched = content.replace(OLD, NEW, 1)
            tmp = "/tmp/builtin_tools_patched.py"
            with d.sftp.open(tmp, "w") as f:
                f.write(patched)
            d.sh("docker cp %s %s:%s" % (tmp, C.DIFY_API_CTR, REMOTE))
            print("已精确写入 credential_info 补丁")

        d.sh("docker restart %s" % C.DIFY_API_CTR)
        print("等待 api 起来...")
        d.sh(
            "for i in 1 2 3 4 5 6 7 8 9 10; do "
            "curl -sf -o /dev/null -m 3 http://127.0.0.1/console/api/setup || true; sleep 2; done"
        )
        d.login()
        path = (
            "/workspaces/current/tool-provider/builtin/%s/credential/info"
            % C.SERVER_STATUS_PROVIDER_ID
        )
        r = d.get(path)
        print("GET", path, "HTTP", r.get("code"))
        print((r.get("text") or "")[:400])
        ok_time = d.get("/workspaces/current/tool-provider/builtin/time/credential/info")
        print("time still", ok_time.get("code"))
        if r.get("code") != "200":
            return 1
        print("[PASS] 刷新浏览器打开运维巡检 Agent 配置页，红条应消失。")
        return 0
    finally:
        d.close()


if __name__ == "__main__":
    sys.exit(main())

# -*- coding: utf-8 -*-
"""配置页 Internal Server Error · 修改前（摘自 Dify 1.16.1
docker-api-1:/app/api/services/tools/builtin_tools_manage_service.py
函数 get_builtin_tool_provider_credential_info）。

本文件是「要替换的那段函数头部」的完整对照，不是整个 800+ 行服务文件。
应用请用：/usr/bin/python3 /opt/workbuddy/scripts_cursor/Dify_专题十六_新Agent配置页InternalServerError/作业1_06_修复配置页InternalServerError.py
"""
from __future__ import annotations

from sqlalchemy.orm import Session

from core.tools.entities.api_entities import ToolProviderCredentialInfoApiEntity
from core.tools.tool_manager import ToolManager
from models.account import Account


class BuiltinToolManageService:
    @staticmethod
    def get_builtin_tool_provider_credential_info(
        tenant_id: str,
        provider: str,
        session: Session,
        user: Account | None = None,
        include_credential_ids: list[str] | None = None,
    ) -> ToolProviderCredentialInfoApiEntity:
        """
        get builtin tool provider credential info
        """
        provider_controller = ToolManager.get_builtin_provider(provider, tenant_id)
        supported_credential_types = provider_controller.get_supported_credential_types()
        credentials = BuiltinToolManageService.get_builtin_tool_provider_credentials(
            tenant_id,
            provider,
            session=session,
            user=user,
            include_credential_ids=include_credential_ids,
        )
        credential_info = ToolProviderCredentialInfoApiEntity(
            supported_credential_types=supported_credential_types,
            is_oauth_custom_client_enabled=BuiltinToolManageService.is_oauth_custom_client_enabled(tenant_id, provider),
            credentials=credentials,
        )
        return credential_info

# -*- coding: utf-8 -*-
"""配置页 Internal Server Error · 修改后（摘自 Dify 1.16.1
docker-api-1:/app/api/services/tools/builtin_tools_manage_service.py
函数 get_builtin_tool_provider_credential_info）。

相对修改前只多了 try/except：插件不存在时返回空凭据 JSON，HTTP 200。
应用请用：/usr/bin/python3 /opt/workbuddy/scripts_cursor/Dify_专题十六_新Agent配置页InternalServerError/作业1_06_修复配置页InternalServerError.py
"""
from __future__ import annotations

import logging

from sqlalchemy.orm import Session

from core.tools.entities.api_entities import ToolProviderCredentialInfoApiEntity
from core.tools.tool_manager import ToolManager
from models.account import Account

logger = logging.getLogger(__name__)


class BuiltinToolManageService:
    @staticmethod
    def get_builtin_tool_provider_credential_info(
        tenant_id: str,
        provider: str,
        session: Session,
        user: Account | None = None,
        include_credential_ids: list[str] | None = None,
    ) -> ToolProviderCredentialInfoApiEntity:
        """
        get builtin tool provider credential info
        """
        try:
            provider_controller = ToolManager.get_builtin_provider(provider, tenant_id)
        except Exception as exc:
            err = str(exc).lower()
            if type(exc).__name__ in (
                "PluginNotFoundError",
                "ToolProviderNotFoundError",
            ) or "plugin not found" in err:
                logger.warning(
                    "skip builtin credential/info for non-plugin provider %s: %s",
                    provider,
                    exc,
                )
                return ToolProviderCredentialInfoApiEntity(
                    supported_credential_types=[],
                    is_oauth_custom_client_enabled=False,
                    credentials=[],
                )
            raise
        supported_credential_types = provider_controller.get_supported_credential_types()
        credentials = BuiltinToolManageService.get_builtin_tool_provider_credentials(
            tenant_id,
            provider,
            session=session,
            user=user,
            include_credential_ids=include_credential_ids,
        )
        credential_info = ToolProviderCredentialInfoApiEntity(
            supported_credential_types=supported_credential_types,
            is_oauth_custom_client_enabled=BuiltinToolManageService.is_oauth_custom_client_enabled(tenant_id, provider),
            credentials=credentials,
        )
        return credential_info

{
  "supported_credential_types": [],
  "is_oauth_custom_client_enabled": false,
  "credentials": []
}

/dify/dify-main/docker/
├── docker-compose.yaml              # 官方原文件，不动
├── docker-compose.override.yaml     # 新增：只做一件事 —— 挂补丁
└── volumes/
    └── patches/
        └── builtin_tools_manage_service.py      # 打过补丁的完整文件

# 修 Internal Server Error：用只读挂载覆盖 api 容器里的那个文件
# 这样容器重建 / 换镜像 / compose up -d 都不会把补丁冲掉
services:
  api:
    volumes:
      - ./volumes/patches/builtin_tools_manage_service.py:/app/api/services/tools/builtin_tools_manage_service.py:ro

cd /dify/dify-main/docker
docker compose up -d api        # override 会被自动合并，无需 -f 指定
docker exec docker-api-1 sh -lc \
  'ls -la /app/api/services/tools/builtin_tools_manage_service.py && grep -c PluginNotFoundError /app/api/services/tools/builtin_tools_manage_service.py'

IMG=$(docker inspect docker-api-1 --format '{{.Config.Image}}')
docker run --rm --entrypoint cat "$IMG" \
  /app/api/services/tools/builtin_tools_manage_service.py \
  > /tmp/builtin_tools_orig.py
docker cp /tmp/builtin_tools_orig.py docker-api-1:/app/api/services/tools/builtin_tools_manage_service.py
docker restart docker-api-1