Docker中运行Dart应用提示libdart_sqlite.so找不到问题求助

我来帮你搞定这个问题——这个坑我之前也踩过，核心原因是google/dart-runtime镜像是高度精简的运行时环境，本身不包含libdart_sqlite.so这个第三方本地库，而且单纯执行pub upgrade只会拉取dart-sqlite的源码，不会自动把这个库放到系统能识别的路径里。下面是具体的解决步骤：

1. 先明确本地库的位置 #

当你通过git拉取putraxor/dart-sqlite依赖后，libdart_sqlite.so文件一般会出现在项目的packages/sqlite/目录下（Dart项目基本是这个路径）。你可以先在本地项目里确认这个文件的位置，确保路径没错。

2. 调整Dockerfile，把库文件放到系统能找到的地方 #

系统默认会从/usr/lib、/lib这类标准路径查找共享库，所以我们需要把libdart_sqlite.so复制到这些目录，或者指定库的加载路径。这里给你两种可行方案：

方案一：多阶段构建（推荐，镜像更精简安全） #

先用包含完整Dart SDK的镜像完成依赖安装和文件准备，再把需要的内容复制到轻量的runtime镜像中：

# 第一阶段：用SDK镜像处理依赖和文件
FROM google/dart-sdk AS builder

WORKDIR /app

# 先复制pubspec文件，利用Docker缓存优化构建速度
COPY pubspec.* ./
RUN pub get

# 复制整个项目源码
COPY . .

# 第二阶段：用runtime镜像运行应用
FROM google/dart-runtime

# 从builder阶段把libdart_sqlite.so复制到系统库目录
COPY --from=builder /app/packages/sqlite/libdart_sqlite.so /usr/lib/

# 复制项目文件到runtime镜像
WORKDIR /app
COPY --from=builder /app/ .

# 替换成你的应用启动命令，比如运行bin下的主文件
CMD ["dart", "bin/main.dart"]

方案二：直接在runtime镜像中处理（适合快速调试） #

如果不想用多阶段构建，也可以在runtime镜像里手动处理库文件：

FROM google/dart-runtime

USER root

WORKDIR /app

# 复制pubspec并安装依赖
COPY pubspec.* ./
RUN pub get

# 复制项目源码
COPY . .

# 把libdart_sqlite.so复制到系统库目录，然后更新库缓存
RUN cp packages/sqlite/libdart_sqlite.so /usr/lib/ && ldconfig

# 切换回非root用户，符合Docker安全最佳实践
USER dart

# 启动你的应用
CMD ["dart", "bin/main.dart"]

3. 额外验证技巧 #

如果还是报错，可以在Dockerfile里加一行命令检查库是否被系统识别：

RUN ldconfig -p | grep libdart_sqlite

如果输出里能看到libdart_sqlite.so的条目，说明路径配置没问题。

另外，也可以通过设置环境变量指定库的加载路径，比如在启动命令前添加：

ENV LD_LIBRARY_PATH=/app/packages/sqlite:$LD_LIBRARY_PATH

这样系统会优先从这个路径查找共享库，适合不想改动系统目录的场景。

内容的提问来源于stack exchange，提问作者Putra Ardiansyah