Docker构建时提示Unable to locate package libqt4-dev该如何解决？

报错核心原因 #

libqt4-dev是Qt4框架的开发依赖包，Qt4已于2015年停止官方维护，目前Ubuntu 20.04+、Debian 11+等主流新发行版的官方软件源已经完全移除了Qt4相关软件包，这是该报错出现的最常见原因。

排查步骤 #

• 确认Dockerfile使用的基础镜像版本，运行以下命令查看镜像对应的系统版本：
  docker run --rm <你的基础镜像名称:标签> cat /etc/os-release
• 检查Dockerfile中安装依赖前是否执行了apt update命令，是否存在源更新失败被跳过的情况。

解决方法 #

方案1：更换仍支持Qt4的旧版本基础镜像 #

如果项目必须依赖Qt4，优先选择官方源仍包含Qt4的旧发行版作为构建基础镜像：

• Ubuntu系列可选ubuntu:18.04
• Debian系列可选debian:10
  Dockerfile参考写法：

FROM ubuntu:18.04
RUN apt update && apt install -y libqt4-dev

方案2：为新基础镜像添加第三方Qt4源 #

如果必须使用新版本系统作为基础镜像，可以添加社区维护的第三方Qt4源，以Ubuntu 20.04为例：

FROM ubuntu:20.04
RUN apt update && apt install -y software-properties-common \
    && add-apt-repository ppa:rock-core/qt4 \
    && apt update \
    && apt install -y libqt4-dev

注：第三方源无官方安全维护，生产环境使用前请自行评估风险

方案3：升级项目依赖到Qt5/Qt6 #

长期维护的项目建议将Qt4依赖迁移到仍在官方维护的Qt5或Qt6版本，对应的开发包名为qtbase5-dev，安装命令为：
apt install -y qtbase5-dev
该方案兼容性最好，无安全隐患，是长期项目的优先选择。

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