Docker Compose构建报错：无法选择软件包及iconv编译异常求助

初始错误：apk无法找到指定包 #

错误现象 #

执行docker compose build或docker compose build --no-cache时，apk安装命令返回大量包不存在的错误，包括php7-bcmath、php7-ctype等PHP扩展包，以及python2。关键错误片段：

ERROR: unable to select packages:
  php7-bcmath (no such package):
    required by: world[php7-bcmath]
  ...
  python2 (no such package):
    required by: world[python2]

原因 #

默认的php:7.4-fpm-alpine镜像对应Alpine 3.16版本，而Alpine 3.16开始：

• 官方仓库移除了PHP 7.x系列包，默认提供PHP 8.x版本
• Python 2已从默认仓库中移除，不再支持

解决方案 #

将基础镜像指定为仍保留PHP 7.x和Python 2的Alpine 3.15版本：

FROM php:7.4-fpm-alpine3.15

后续错误：iconv扩展编译失败 #

错误现象 #

更换镜像后，执行docker-php-ext-install安装iconv时出现编译错误，关键信息：

/usr/src/php/ext/iconv/iconv.c:284:4: error: '_libiconv_version' undeclared (first use in this function)

原因 #

php:7.4-fpm-alpine3.15基础镜像中已内置iconv扩展，无需通过docker-php-ext-install再次编译安装。手动重复安装会与系统自带的libiconv库产生冲突，导致编译失败。

解决方案 #

修改Dockerfile中的docker-php-ext-install命令，移除iconv参数：

RUN docker-php-ext-install intl zip pcntl pdo_mysql opcache soap tidy imap bcmath \
    && php -r 'ini_set("display_errors", 1); error_reporting(-1); iconv("UTF-8", "ASCII//TRANSLIT", "foobar");'

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