Ubuntu下安装php-mysql时依赖未满足问题的解决办法

错误原因分析 #

你遇到的错误是版本不匹配导致的依赖冲突，具体提示如下：

php8.1-mysql : Depends: php8.1-common (= 8.1.7-1ubuntu3.3) but 8.1.13-1+ubuntu22.04.1+deb.sury.org+1 is to be installed
E: Unable to correct problems, you have held broken packages.

本质是php8.1-mysql需要特定版本的php8.1-common，但系统中待安装的php8.1-common来自第三方源（deb.sury.org）的更高版本，同时系统存在损坏的锁定包，导致安装流程中断。

解决步骤 #

• 第一步：修复损坏的依赖和锁定包
  先更新软件源，再让系统自动修复依赖问题：

  sudo apt update
  sudo apt --fix-broken install
  

• 第二步：检查并解锁锁定的包
  查看系统中被锁定的包：

  sudo apt-mark showhold
  

  如果输出里有php8.1-common或相关PHP包，执行命令解锁：

  sudo apt-mark unhold php8.1-common
  

• 第三步：降级php8.1-common到依赖要求的版本
  直接指定版本安装所需的php8.1-common：

  sudo apt install php8.1-common=8.1.7-1ubuntu3.3
  

  完成后再执行php-mysql的安装命令：

  sudo apt install php-mysql
  

• 第四步：禁用第三方PHP源（若上述方法无效）
  错误里的高版本php8.1-common来自deb.sury.org第三方源，可能和官方源冲突，尝试禁用该源：

  1. 编辑源列表文件：

     sudo nano /etc/apt/sources.list.d/sury-php.list
     

  2. 在文件每一行开头加#注释所有内容，按Ctrl+O保存，Ctrl+X退出编辑器。
  3. 更新源并重新安装：

     sudo apt update
     sudo apt install php-mysql
     

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