From 5de87465bc7609c9e929d684113920520514571f Mon Sep 17 00:00:00 2001
From: butubb <1422726308@qq.com>
Date: Wed, 19 Aug 2026 16:17:28 +0800
Subject: [PATCH] =?UTF-8?q?fix:=20start.sh=20=E4=BF=AE=E5=A4=8D=E9=A1=BA?=
 =?UTF-8?q?=E5=BA=8F=E2=80=94=E2=80=94rapidocr=20=E4=BE=9D=E8=B5=96?=
 =?UTF-8?q?=E5=A3=B0=E6=98=8E=20opencv-python=20=E4=BC=9A=E8=A2=AB=20pip?=
 =?UTF-8?q?=20=E5=BC=BA=E5=88=B6=E8=A3=85=E5=9B=9E=20GUI=20=E7=89=88?=
 =?UTF-8?q?=EF=BC=8Cuninstall=20=E5=BF=85=E9=A1=BB=E5=9C=A8=20pip=20instal?=
 =?UTF-8?q?l=20=E4=B9=8B=E5=90=8E=E6=9C=80=E5=90=8E=E6=89=A7=E8=A1=8C?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 scripts/start.sh | 18 +++++++++++-------
 1 file changed, 11 insertions(+), 7 deletions(-)

diff --git a/scripts/start.sh b/scripts/start.sh
index e00095a..bd67009 100755
--- a/scripts/start.sh
+++ b/scripts/start.sh
@@ -1,15 +1,19 @@
 #!/bin/bash
-# 容器启动脚本：环境修复 + 安装依赖 + 启动 web_server。
-# compose 的 python-app / python-app-main 服务 command 指向本脚本。
+# 容器启动脚本：安装依赖 + 环境修复 + 启动 web_server。
+# compose 的 python-app 服务 command 指向本脚本。
 #
-# 为什么需要环境修复：
-#   opencv-python（GUI 版）依赖 X11 库（libxcb），python:slim 容器里 import cv2
+# 为什么需要环境修复（必须在 pip install 之后）：
+#   rapidocr_onnxruntime 的依赖声明是 opencv-python（GUI 版），pip 解析依赖时
+#   会强制装回它；而 GUI 版依赖 X11 库（libxcb），python:slim 容器里 import cv2
 #   直接崩溃 → RapidOCR 不可用 → 条件判断的 OCR 步骤抛异常 → 任务失败退出。
-#   这里幂等卸载 GUI 版并保证安装 headless 版（本地 Mac 有 GUI 环境不受影响）。
-pip uninstall -y -q opencv-python 2>/dev/null || true
-
+#   因此在安装完 requirements 后，最后强制卸载 GUI 版并装 headless（幂等）。
+#   本地 Mac 有 GUI 环境不受影响。
 if [ -f requirements.txt ]; then
     pip install --no-cache-dir -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt
 fi
 
+# 环境修复：最后强制 headless（覆盖 rapidocr 拉回的 GUI 版）
+pip uninstall -y -q opencv-python 2>/dev/null || true
+pip install -q -i https://pypi.tuna.tsinghua.edu.cn/simple opencv-python-headless
+
 exec python -u web_server.py