Docker部署PHP环境报错：No releases available for package "pecl.php.net/xdebug"

以下是几个简单易操作的解决方案，按顺序尝试即可：

• 检查WSL网络连通性
  打开WSL终端，执行ping pecl.php.net，如果ping不通，说明WSL更新后网络配置异常：

  1. 执行wsl --shutdown关闭所有WSL实例，重新打开WSL后再尝试构建
  2. 若仍无法连通，可尝试切换WSL版本为1：wsl --set-version <你的发行版名称> 1（例如Ubuntu发行版就执行wsl --set-version Ubuntu 1），之后再运行docker-compose up -d

• 更换pecl国内镜像源
  官方pecl源可能存在访问不稳定的情况，在Dockerfile中RUN pecl install xdebug这一行之前添加以下命令：

  RUN pecl config set mirror pecl.php.net https://mirrors.aliyun.com/pecl/
  RUN pecl config set preferred_state stable
  

  国内镜像访问速度更快，能有效避免找不到包的问题

• 指定xdebug的具体版本
  不同PHP版本对应不同的xdebug兼容版本，若你的PHP版本较旧，最新版xdebug可能不再支持：

  • PHP7.4对应xdebug3.1.x：RUN pecl install xdebug-3.1.6
  • PHP8.0对应xdebug3.2.x：RUN pecl install xdebug-3.2.2
  • PHP8.1及以上对应xdebug3.3.x：RUN pecl install xdebug-3.3.2
    先查看Dockerfile开头的PHP基础镜像版本（例如FROM php:7.4-fpm），再选择对应版本安装

• 改用系统包管理器安装xdebug
  如果使用的是Debian/Ubuntu系列的PHP镜像，直接用apt安装更简单，替换掉pecl install的命令：

  RUN apt-get update && apt-get install -y php-xdebug
  

  注意必须先执行apt-get update，否则可能找不到对应的包

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