deploy: 93de9eb — 更新 Dockerfile.huggingface

Dockerfile

@@ -11,27 +11,23 @@
 #   [Bug2]  build-essential for better-sqlite3 node-gyp fallback
 #   [Bug3]  npm install --omit=dev (--only=production deprecated in npm v10)
 #   [Bug5]  ARG LITELLM_VERSION for single-source versioning
-#   [BugP]  prisma generate — LiteLLM v1.61+ initialises its Prisma client at
-#           lifespan startup whenever database_url is present in config. The
-#           prisma-client-py package requires the Prisma query-engine binary to
-#           exist before the process starts. Without this step the container
-#           crashes immediately with:
+#   [BugP]  prisma generate — LiteLLM v1.61+ 在 database_url 存在时会在 FastAPI
+#           lifespan 启动阶段初始化 Prisma 客户端，需要 query-engine 二进制文件
+#           预先存在。否则容器立即崩溃：
 #             ModuleNotFoundError: No module named 'prisma'
 #             Exception: Unable to find Prisma binaries.
 #                        Please run 'prisma generate' first.
 #
-#           IMPORTANT — cache-dir alignment:
-#           prisma-client-py stores the downloaded query-engine binary in
-#           PRISMA_BINARY_CACHE_DIR (default: ~/.cache/prisma-binaries/).
-#           If we run `prisma generate` as root during the build, binaries land
-#           in /root/.cache/. At runtime the container runs as uid=1000 (user),
-#           which looks in /home/user/.cache/ — a completely different path, so
-#           the binary is never found.
-#
-#           Fix: set PRISMA_BINARY_CACHE_DIR=/app/.prisma (a path under /app
-#           that gets chowned to user:user later in this file). Both the build
-#           step and the runtime process use this same env-var, so the binary is
-#           always found regardless of which uid is active.
+#           根因分析（三层）：
+#           1. litellm[proxy]==1.81.14 的依赖树里 **没有** prisma 包，
+#              必须显式 pip install prisma。
+#           2. prisma generate 产生的 query-engine 二进制默认写入
+#              ~/.cache/prisma-binaries/（即 root 的 /root/.cache/），
+#              但容器运行时是 uid=1000(user)，查找路径是
+#              /home/user/.cache/ → 完全不同的目录 → 找不到。
+#           3. 修复：设 PRISMA_BINARY_CACHE_DIR=/app/.prisma（在 /app 下，
+#              后续 chown -R user:user /app 会覆盖到这里），build 阶段和
+#              运行时都读同一个环境变量，路径始终一致。
 
 FROM node:20-alpine AS frontend-builder
 WORKDIR /build
@@ -47,9 +43,8 @@ FROM python:3.11-slim
 
 ARG LITELLM_VERSION=1.81.14
 
-# Point prisma-client-py at a stable, user-writable cache directory.
-# This env var must be set before `prisma generate` and must persist into the
-# final container so the runtime process finds the binary in the same place.
+# 把 prisma 二进制缓存目录固定到 /app/.prisma，
+# 使 build 阶段（root）和运行时（uid=1000）使用同一路径。
 ENV PRISMA_BINARY_CACHE_DIR=/app/.prisma
 
 RUN apt-get update && apt-get install -y --no-install-recommends \
@@ -59,16 +54,16 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
     && apt-get purge -y gnupg && apt-get autoremove -y \
     && rm -rf /var/lib/apt/lists/*
 
-# Install LiteLLM and run prisma generate in a single layer (as root, so
-# pip can write to system site-packages). The query-engine binary is written
-# to $PRISMA_BINARY_CACHE_DIR (/app/.prisma) which is later chowned to
-# user:user, making it readable at runtime.
-RUN pip install --no-cache-dir "litellm[proxy]==${LITELLM_VERSION}" \
+# [BugP 修复]
+# litellm[proxy]==1.81.14 的依赖里不含 prisma，需要单独安装。
+# 安装后立即执行 prisma generate，将 query-engine 写入
+# $PRISMA_BINARY_CACHE_DIR（/app/.prisma），后续 chown 会一并处理权限。
+RUN pip install --no-cache-dir "litellm[proxy]==${LITELLM_VERSION}" prisma \
     && mkdir -p "${PRISMA_BINARY_CACHE_DIR}" \
     && SCHEMA_PATH=$(python3 -c \
          "import litellm, os; \
           print(os.path.join(os.path.dirname(litellm.__file__), 'proxy', 'schema.prisma'))") \
-    && echo "Running prisma generate --schema ${SCHEMA_PATH}" \
+    && echo "Running: prisma generate --schema ${SCHEMA_PATH}" \
     && prisma generate --schema "${SCHEMA_PATH}"
 
 RUN useradd -m -u 1000 -s /bin/bash user

Dockerfile.huggingface

@@ -11,27 +11,23 @@
 #   [Bug2]  build-essential for better-sqlite3 node-gyp fallback
 #   [Bug3]  npm install --omit=dev (--only=production deprecated in npm v10)
 #   [Bug5]  ARG LITELLM_VERSION for single-source versioning
-#   [BugP]  prisma generate — LiteLLM v1.61+ initialises its Prisma client at
-#           lifespan startup whenever database_url is present in config. The
-#           prisma-client-py package requires the Prisma query-engine binary to
-#           exist before the process starts. Without this step the container
-#           crashes immediately with:
+#   [BugP]  prisma generate — LiteLLM v1.61+ 在 database_url 存在时会在 FastAPI
+#           lifespan 启动阶段初始化 Prisma 客户端，需要 query-engine 二进制文件
+#           预先存在。否则容器立即崩溃：
 #             ModuleNotFoundError: No module named 'prisma'
 #             Exception: Unable to find Prisma binaries.
 #                        Please run 'prisma generate' first.
 #
-#           IMPORTANT — cache-dir alignment:
-#           prisma-client-py stores the downloaded query-engine binary in
-#           PRISMA_BINARY_CACHE_DIR (default: ~/.cache/prisma-binaries/).
-#           If we run `prisma generate` as root during the build, binaries land
-#           in /root/.cache/. At runtime the container runs as uid=1000 (user),
-#           which looks in /home/user/.cache/ — a completely different path, so
-#           the binary is never found.
-#
-#           Fix: set PRISMA_BINARY_CACHE_DIR=/app/.prisma (a path under /app
-#           that gets chowned to user:user later in this file). Both the build
-#           step and the runtime process use this same env-var, so the binary is
-#           always found regardless of which uid is active.
+#           根因分析（三层）：
+#           1. litellm[proxy]==1.81.14 的依赖树里 **没有** prisma 包，
+#              必须显式 pip install prisma。
+#           2. prisma generate 产生的 query-engine 二进制默认写入
+#              ~/.cache/prisma-binaries/（即 root 的 /root/.cache/），
+#              但容器运行时是 uid=1000(user)，查找路径是
+#              /home/user/.cache/ → 完全不同的目录 → 找不到。
+#           3. 修复：设 PRISMA_BINARY_CACHE_DIR=/app/.prisma（在 /app 下，
+#              后续 chown -R user:user /app 会覆盖到这里），build 阶段和
+#              运行时都读同一个环境变量，路径始终一致。
 
 FROM node:20-alpine AS frontend-builder
 WORKDIR /build
@@ -47,9 +43,8 @@ FROM python:3.11-slim
 
 ARG LITELLM_VERSION=1.81.14
 
-# Point prisma-client-py at a stable, user-writable cache directory.
-# This env var must be set before `prisma generate` and must persist into the
-# final container so the runtime process finds the binary in the same place.
+# 把 prisma 二进制缓存目录固定到 /app/.prisma，
+# 使 build 阶段（root）和运行时（uid=1000）使用同一路径。
 ENV PRISMA_BINARY_CACHE_DIR=/app/.prisma
 
 RUN apt-get update && apt-get install -y --no-install-recommends \
@@ -59,16 +54,16 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
     && apt-get purge -y gnupg && apt-get autoremove -y \
     && rm -rf /var/lib/apt/lists/*
 
-# Install LiteLLM and run prisma generate in a single layer (as root, so
-# pip can write to system site-packages). The query-engine binary is written
-# to $PRISMA_BINARY_CACHE_DIR (/app/.prisma) which is later chowned to
-# user:user, making it readable at runtime.
-RUN pip install --no-cache-dir "litellm[proxy]==${LITELLM_VERSION}" \
+# [BugP 修复]
+# litellm[proxy]==1.81.14 的依赖里不含 prisma，需要单独安装。
+# 安装后立即执行 prisma generate，将 query-engine 写入
+# $PRISMA_BINARY_CACHE_DIR（/app/.prisma），后续 chown 会一并处理权限。
+RUN pip install --no-cache-dir "litellm[proxy]==${LITELLM_VERSION}" prisma \
     && mkdir -p "${PRISMA_BINARY_CACHE_DIR}" \
     && SCHEMA_PATH=$(python3 -c \
          "import litellm, os; \
           print(os.path.join(os.path.dirname(litellm.__file__), 'proxy', 'schema.prisma'))") \
-    && echo "Running prisma generate --schema ${SCHEMA_PATH}" \
+    && echo "Running: prisma generate --schema ${SCHEMA_PATH}" \
     && prisma generate --schema "${SCHEMA_PATH}"
 
 RUN useradd -m -u 1000 -s /bin/bash user