上云 API 2 底座部署过程中部分容器报错：unhealthy

说明：本文档中，应用运行与设备管控底座统一简称为底座。

问题现象

部署上云 API 2 底座时，安装过程卡住并报错，提示以下容器 unhealthy 导致安装脚本中止：

可能涉及的容器包括：

rabbitmq

pf- 开头的业务容器，如 pf-notify-service、pf-atc-service 等

部署界面示例：

Container tas-emqx-service    Healthy
Container live-signaling       Healthy                                                                                                                                     
Container pf-device-service    Healthy                                                                                                                                     
Container live-stream-hub      Healthy                                                                                                                                     
Container live-service         Healthy                                                                                                                                     
container pf-notify-service is unhealthy        ← 安装中止点                                                                                                               
time="2026-06-03T09:33:29Z" level=error msg="exit status 1" step=Run                                                                                                       
time="2026-06-03T09:33:29Z" level=fatal msg="Bootstrap fail: exit status 1"                                                                                                
2026-06-03 09:33:29 install failed: exit status 1

问题原因

原因 1：rabbitmq 权限时序问题

根本原因： 服务器性能不足时，安装脚本为 rabbitmq 目录设置权限的时机，晚于 rabbitmq 容器启动并尝试访问该目录的时机。

原因 2：容器内 CodeMeter 服务未启动

根本原因： 容器内 CodeMeter（授权管理服务）尚未完成初始化，业务服务就已经尝试访问授权，导致授权验证失败 → 容器标记为 unhealthy。

解决步骤

前置说明： 以下操作以安装包 env 配置中的路径为例：
数据目录（data）：/home/data
安装目录（install）：/home/install
修复脚本 patch_run_server.sh 的内容见本文档最后部分，可直接复制并保存至 /mnt/patch_run_server.sh。

实际操作时请替换为真实路径。

步骤 1：卸载当前部署

步骤 2：清理 install 目录下的 compose.yaml 文件:

该文件将在后续安装过程中重新生成。

步骤 3：后台运行修复脚本

新开一个终端窗口后执行：

脚本运行后不要关闭该终端，让它在后台持续监听，直到两个任务都完成后自动退出。

步骤 4：执行安装

回到原终端，执行安装命令，等待安装成功即可：

--need_load_image=false 表示不重新加载镜像，直接使用已有镜像，加快安装速度。

安装过程中，步骤 3 的脚本会在 compose.yaml 生成后自动完成 CodeMeter 注入和 cookie 权限修正，无需人工干预。 ---

上云 API 2 底座部署过程中部分容器报错：unhealthy

问题现象#

问题原因#

原因 1：rabbitmq 权限时序问题#

原因 2：容器内 CodeMeter 服务未启动#

解决步骤#

步骤 1：卸载当前部署#

步骤 2：清理 install 目录下的 compose.yaml 文件:#

步骤 3：后台运行修复脚本#

步骤 4：执行安装#

patch_run_server.sh 脚本内容#