dotnet coverage执行测试时提示No usable version of libssl was found的解决方法

问题根源 #

这个错误核心原因是.NET Core 3.1依赖的libssl1.1版本，和较新Debian/Ubuntu镜像默认提供的libssl3不兼容——.NET Core 3.1无法识别高版本的libssl库，仅支持1.1系列。你之前安装的libssl_dev是开发头文件，不是运行时依赖，因此无法解决问题。

具体解决方案 #

1. 基于官方.NET SDK镜像构建 #

优先选择微软官方的.NET 8 SDK镜像作为基础（比如mcr.microsoft.com/dotnet/sdk:8.0-bookworm-slim），这类镜像已内置.NET 6/8环境，只需补充.NET 3.1和兼容的libssl版本即可，避免自定义基础镜像带来的依赖缺失问题。

2. 安装兼容的libssl运行时 #

根据基础镜像的发行版，添加对应源并安装libssl1.1：

• 若基础镜像是Debian 12（Bookworm）：

  # 添加backports源获取libssl1.1
  RUN echo "deb http://deb.debian.org/debian bookworm-backports main" >> /etc/apt/sources.list
  RUN apt-get update && apt-get install -y --no-install-recommends libssl1.1
  

• 若基础镜像是Ubuntu 22.04（Jammy）：

  # 添加Ubuntu 20.04安全源获取libssl1.1
  RUN echo "deb http://security.ubuntu.com/ubuntu focal-security main" >> /etc/apt/sources.list
  RUN apt-get update && apt-get install -y --no-install-recommends libssl1.1
  

3. 正确安装.NET 3.1 SDK #

使用微软官方安装脚本，确保安装路径和已有.NET 6/8一致，避免环境变量冲突：

RUN curl -sSL https://dot.net/v1/dotnet-install.sh | bash /dev/stdin --version 3.1.426 --install-dir /usr/share/dotnet

4. 配置统一环境变量 #

确保所有.NET版本的环境变量一致：

ENV DOTNET_ROOT=/usr/share/dotnet
ENV PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools

5. 清理缓存减小镜像体积 #

安装完成后清理APT缓存，避免镜像臃肿：

RUN apt-get clean && rm -rf /var/lib/apt/lists/*

完整Dockerfile示例 #

FROM mcr.microsoft.com/dotnet/sdk:8.0-bookworm-slim

# 安装libssl1.1运行时
RUN echo "deb http://deb.debian.org/debian bookworm-backports main" >> /etc/apt/sources.list
RUN apt-get update && apt-get install -y --no-install-recommends libssl1.1 \
    && apt-get clean && rm -rf /var/lib/apt/lists/*

# 安装.NET Core 3.1 SDK
RUN curl -sSL https://dot.net/v1/dotnet-install.sh | bash /dev/stdin --version 3.1.426 --install-dir /usr/share/dotnet

# 配置.NET环境变量
ENV DOTNET_ROOT=/usr/share/dotnet
ENV PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools

# 验证SDK安装情况
RUN dotnet --list-sdks

GitLab CI配置注意事项 #

• 确保CI任务指定使用你构建的自定义镜像，而非默认官方镜像
• 所有依赖均提前打包进镜像，不要在CI步骤中临时安装，避免网络波动和版本不一致问题

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