部署ASP.NET Core API至Cloud Run时libdb2.so加载失败求助

问题描述 #

尝试将依赖DB2驱动的ASP.NET Core API部署至Google Cloud Run无服务器容器，使用NuGet包Net5.IBM.Data.Db2-lnx 5.0.0.500获取DB2驱动包，但API启动时抛出错误：

Unable to load shared library 'libdb2.so' or one of its dependencies. In order to help diagnose loading problems, consider setting the LD_DEBUG environment variable: liblibdb2.so: cannot open shared object file: No such file or directory

对应的Dockerfile内容：

FROM mcr.microsoft.com/dotnet/aspnet:5.0 AS base
RUN apt-get update -y && apt-get install jq dos2unix curl -y

WORKDIR /app
EXPOSE 80
EXPOSE 443

RUN chmod -R 777 /app
ENV DB2_CLI_DRIVER_INSTALL_PATH=/app/clidriver
ENV LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/app/clidriver/lib
ENV LIBPATH=/app/clidriver/lib
ENV PATH=$PATH:/app/clidriver/bin:/app/clidriver/lib

FROM mcr.microsoft.com/dotnet/sdk:5.0 AS build

WORKDIR /src
COPY ["SourceCode/SomeAPI.WebApi/SomeAPI.WebApi.csproj", "SourceCode/SomeAPI.WebApi/"]
RUN dotnet restore "SourceCode/SomeAPI.WebApi/SomeAPI.WebApi.csproj"
COPY . .
WORKDIR "/src/SourceCode/SomeAPI.WebApi"
RUN dotnet build "SomeAPI.WebApi.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "SomeAPI.WebApi.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "SomeAPI.WebApi.dll"]

解决方案 #

1. 修复环境变量设置 #

原LD_LIBRARY_PATH的拼接顺序可能导致空值前缀，修改为优先指定驱动路径：

# 替换base阶段的LD_LIBRARY_PATH设置
ENV LD_LIBRARY_PATH=/app/clidriver/lib:$LD_LIBRARY_PATH

2. 安装DB2依赖的系统库 #

默认ASP.NET镜像缺少libdb2.so依赖的系统级共享库，在base阶段补充安装：

# 更新apt-get命令，添加必要依赖
RUN apt-get update -y && apt-get install jq dos2unix curl libpam0g libaio1 libnsl2 -y

3. 确认驱动文件执行权限 #

在final阶段明确授予libdb2.so可执行权限：

# 在final阶段添加权限设置
RUN chmod +x /app/clidriver/lib/libdb2.so

修改后的完整Dockerfile #

FROM mcr.microsoft.com/dotnet/aspnet:5.0 AS base
RUN apt-get update -y && apt-get install jq dos2unix curl libpam0g libaio1 libnsl2 -y

WORKDIR /app
EXPOSE 80
EXPOSE 443

RUN chmod -R 777 /app
ENV DB2_CLI_DRIVER_INSTALL_PATH=/app/clidriver
ENV LD_LIBRARY_PATH=/app/clidriver/lib:$LD_LIBRARY_PATH
ENV LIBPATH=/app/clidriver/lib
ENV PATH=$PATH:/app/clidriver/bin:/app/clidriver/lib

FROM mcr.microsoft.com/dotnet/sdk:5.0 AS build

WORKDIR /src
COPY ["SourceCode/SomeAPI.WebApi/SomeAPI.WebApi.csproj", "SourceCode/SomeAPI.WebApi/"]
RUN dotnet restore "SourceCode/SomeAPI.WebApi/SomeAPI.WebApi.csproj"
COPY . .
WORKDIR "/src/SourceCode/SomeAPI.WebApi"
RUN dotnet build "SomeAPI.WebApi.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "SomeAPI.WebApi.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
RUN chmod +x /app/clidriver/lib/libdb2.so
ENTRYPOINT ["dotnet", "SomeAPI.WebApi.dll"]

额外排查步骤 #

若问题仍存在，可在Cloud Run服务配置中添加环境变量LD_DEBUG=libs，查看详细的库加载日志，定位具体缺失的依赖项。

内容的提问来源于stack exchange，提问作者Small Engineer