如何避免Docker构建时LD_LIBRARY_PATH相关警告

一、正确追加环境变量且不触发警告的方式 #

Docker build的--check参数会严格校验Dockerfile中的变量引用，当基础镜像未定义LD_LIBRARY_PATH时，直接用ENV LD_LIBRARY_PATH="/app:$LD_LIBRARY_PATH"会触发未定义变量警告。可以用以下两种方式解决：

方式1：通过RUN命令借助shell处理变量 #

利用shell的参数展开特性，未定义的变量会被自动视为空值，不会触发Docker的校验警告。将环境变量写入容器的全局配置文件，确保所有shell会话都能生效：

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
RUN echo 'export LD_LIBRARY_PATH="/app:${LD_LIBRARY_PATH:-}"' >> /etc/bash.bashrc

如果需要让非shell启动的进程也能读取到该变量，可以写入/etc/environment文件：

RUN echo 'LD_LIBRARY_PATH="/app:${LD_LIBRARY_PATH:-}"' >> /etc/environment

方式2：先判断基础镜像是否存在变量再设置 #

如果不确定基础镜像是否存在目标变量，可以通过RUN命令做条件判断，再决定是追加还是初始化：

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
RUN if [ -z "$LD_LIBRARY_PATH" ]; then \
        export LD_LIBRARY_PATH="/app"; \
    else \
        export LD_LIBRARY_PATH="/app:$LD_LIBRARY_PATH"; \
    fi && \
    echo "LD_LIBRARY_PATH=$LD_LIBRARY_PATH" >> /etc/bash.bashrc

二、查看基础镜像中已声明的环境变量 #

直接用docker run启动临时容器并执行env命令，即可列出基础镜像的所有环境变量：

docker run --rm mcr.microsoft.com/dotnet/aspnet:6.0 env

执行后会输出镜像内置的所有环境变量列表，从中可以确认LD_LIBRARY_PATH是否已被定义。

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