如何在Docker容器化Linux环境中配置并初始化Python.NET的C#控制台应用

问题根源 #

虚拟环境（venv）仅包含Python解释器可执行文件、pip安装的包及虚拟环境配置，不会复制系统级的Python共享库（libpython*.so）。这些共享库存储在python:3基础镜像的系统目录中，你当前的Dockerfile只复制了虚拟环境，导致Python.NET找不到必要的动态链接库。

修正后的Dockerfile #

以下是调整后的Dockerfile，核心修改是从python:3镜像中同步系统级Python共享库，并配置动态链接器路径：

FROM mcr.microsoft.com/dotnet/aspnet:7.0 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build
WORKDIR /src
COPY ["Farpoint.Service/Farpoint.Service.csproj", "Farpoint.Service/"]
RUN dotnet restore "Farpoint.Service/Farpoint.Service.csproj"
COPY . .
WORKDIR "/src/Farpoint.Service"
RUN dotnet build "Farpoint.Service.csproj" -c Release -o /app/build

# BEGIN Prepare python env
FROM python:3 as python
RUN python -m venv /venv
COPY --from=build /app/build/python/requirements.txt .
RUN /venv/bin/python -m pip install -r requirements.txt
# END Prepare python env

FROM build AS publish
RUN dotnet publish "Farpoint.Service.csproj" -c Release -o /app/publish /p:UseAppHost=false

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .

# BEGIN Copy python env and system libs
# 复制虚拟环境
COPY --from=python /venv /app/python
# 复制系统级Python共享库（适配python:3镜像的默认路径）
COPY --from=python /usr/local/lib/libpython3*.so* /usr/local/lib/
# 配置动态链接器路径，确保能找到libpython
ENV LD_LIBRARY_PATH="/usr/local/lib:${LD_LIBRARY_PATH}"
# END Copy python env and system libs

ENTRYPOINT ["dotnet", "Farpoint.Service.dll"]

Runtime.PythonDLL 配置 #

在C#代码初始化Python.NET前，需指定系统级共享库的具体路径。你可以先在python:3镜像中执行ls /usr/local/lib/libpython*.so确认版本，比如Python 3.12对应的路径是：

// 初始化PythonEngine前设置
Runtime.PythonDLL = "/usr/local/lib/libpython3.12.so";
PythonEngine.Initialize();

额外注意事项 #

• 版本兼容：确保Python.NET版本与镜像中的Python版本匹配（建议使用Python.NET最新稳定版）
• 固定Python版本：避免使用python:3这类浮动标签，改用python:3.12-slim等具体版本标签，防止镜像更新导致版本不一致
• 验证文件存在：可在Dockerfile的final阶段添加RUN ls /usr/local/lib/libpython*.so，确认共享库已复制成功

内容的提问来源于stack exchange，提问作者Jim Noble