Ubuntu部署WorkBuddy失败主因是libssl、libc6等基础库缺失或版本不兼容，可立即执行四类修复：一、运行宝塔离线脚本重装核心库；二、用apt --fix-broken自动修复依赖；三、重建ldconfig缓存并校验so文件；四、挂载腾讯云预编译依赖快照。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在Ubuntu系统中部署WorkBuddy时遭遇失败，常见原因集中于基础依赖库缺失或版本不兼容，例如libssl、libc6、libstdc++6 或 sqlite3 运行时未就绪。以下是可立即执行的多种依赖库自动修复方案：
一、运行宝塔官方离线修复脚本（推荐：不依赖面板，适配纯净Ubuntu）
该脚本绕过包管理器状态异常，直接重装核心动态库，适用于 apt 损坏、/var/lib/dpkg/status 被破坏等深层故障场景。
1、以 root 身份打开终端，执行下载命令：wget -O bt8-repair.sh http://download.bt.cn/install/bt8-repair.sh
2、赋予执行权限：chmod +x bt8-repair.sh
3、运行修复：bash bt8-repair.sh
4、脚本将自动识别 Ubuntu 系统，执行：apt install --reinstall libssl1.1 libcrypto1.1 libc6 libstdc++6 sqlite3 libsqlite3-dev
二、启用 apt 自动依赖修复机制（适用于 apt 报错含 “unmet dependencies”）
当 apt install 或 dpkg -i 过程中提示依赖冲突或未满足依赖时，该方法可强制解析并安装所有关联包，避免手动逐个补全。
1、更新软件源索引：sudo apt update
2、触发自动修复流程：sudo apt --fix-broken install -y
3、清理缓存并重试依赖安装：sudo apt clean && sudo apt autoremove -y
4、重新安装 WorkBuddy 所需底层组件：sudo apt install -y build-essential curl jq nodejs npm python3-pip sqlite3 libsqlite3-dev
三、重建动态链接库缓存并校验关键so文件（适用于 “error while loading shared libraries” 类报错）
即使库文件物理存在，若 ldconfig 缓存损坏或路径未注册，系统仍无法加载。此步骤确保运行时能正确定位 libc、ssl 等基础符号。
1、检查关键库是否存在：ls -l /usr/lib/x86_64-linux-gnu/libc.so.6 /usr/lib/x86_64-linux-gnu/libssl.so.1.1
2、若任一缺失，从同版本 Ubuntu 镜像提取对应 .so 文件，拷贝至上述路径，并设置权限：sudo chmod 755 /usr/lib/x86_64-linux-gnu/libssl.so.1.1
3、强制刷新动态链接缓存：sudo ldconfig -v | grep -E "(ssl|crypto|c|stdc\+\+)"
4、验证 libc 符号表完整性：ldd --version && /lib64/ld-linux-x86-64.so.2 --verify
四、切换为腾讯云预编译依赖快照（免编译，适用于无网络或 GCC 不可用环境）
该方案跳过本地构建，直接挂载腾讯云提供的已签名、已验证的 Ubuntu 20.04/22.04 兼容依赖快照，规避所有编译与版本协商过程。
1、创建依赖挂载点：sudo mkdir -p /opt/workbuddy-deps
2、下载并解压快照（Ubuntu 22.04）：wget -O deps.tar.gz https://workbuddy.codebuddy.cn/deps/ubuntu22.04-deps-latest.tar.gz && sudo tar -xzf deps.tar.gz -C /opt/workbuddy-deps
3、临时注入路径到动态链接器：echo "/opt/workbuddy-deps/lib" | sudo tee /etc/ld.so.conf.d/workbuddy.conf && sudo ldconfig
4、验证注入生效：ldconfig -p | grep workbuddy
