“filter failed”表明cups过滤器链中断，核心原因包括cups-filters或ghostscript缺失/损坏、权限异常（如/tmp目录无sticky bit或用户不在lpadmin组）、pdf格式特殊需启用“打印为图像”，或设备uri含冗余参数干扰匹配。
麒麟系统添加打印机时提示“filter failed”，说明CUPS在将文档（尤其是PDF）转换为打印机可识别格式的过程中中断，核心卡点在过滤器链缺失、损坏或权限异常，不是驱动没装完，而是转换管道断了。
确认错误来源：先看日志再动手
打开终端，执行：sudo tail -f /var/log/cups/error_log。
在另一窗口尝试打印一份测试PDF，观察日志中是否出现 filter failed、pdftopdf failed 或 Permission denied 字样——只要看到其中任意一条，就坐实是过滤器问题，不用再查驱动是否安装成功。
如果日志里反复出现 Unable to convert file 0 to printable format，说明 cups-filters 根本没加载，必须重装；若报 ghostscript: command not found，则是依赖缺失，得单独补。
重装核心过滤器组件
执行命令：sudo apt-get --reinstall install cups-filters ghostscript。
这一步会强制覆盖已损坏的 pdftopdf、gstoraster 等关键过滤器二进制文件，并拉取配套的 gs（Ghostscript）运行时。注意：不能只装 cups-filters，ghostscript 是 PDF 渲染底层引擎，缺它 cups-filters 就是空壳。
【必须重启 CUPS 服务，否则新过滤器不生效】
执行：sudo systemctl restart cups。
检查并修复用户权限
方法一：确保当前用户属于 lpadmin 组
执行：sudo usermod -aG lpadmin $USER。
这一步赋予你管理打印机队列、读写临时渲染目录（/var/spool/cups/tmp）的权限。很多“filter failed”实际是 cups 进程以 lp 用户身份运行时，无法读取你传入的 PDF 文件——因为文件权限被桌面环境默认设为仅属主可读，而 lp 用户不属于你所在的组。
方法二：验证临时目录权限
执行：ls -ld /var/spool/cups/tmp，输出应含 drwxrwxrwt ——最后一位 t（sticky bit）不可少，否则不同用户进程会互相删临时文件。若不是，运行：sudo chmod 1777 /var/spool/cups/tmp。
绕过过滤器：对顽固PDF启用图像打印模式
第一步：打开系统设置 → 设备 → 打印机，双击已添加的打印机。
第二步：点击“选项”标签页 → 展开“图形”或“高级”区域 → 找到“打印为图像”或“Raster as image”选项，勾选启用。
第三步：点击“应用”保存。此后所有PDF都将跳过 pdftopdf → gstoraster 链路，直接由 CUPS 调用图像渲染后发给打印机，适合含加密字体、JavaScript 或 PDF/A 格式的疑难文件。
注意：开启后打印速度变慢、分辨率受系统缩放影响，仅作故障应急，勿长期开启。
验证网络打印机URI是否携带无效参数
对于IPP或Socket协议的网络打印机，检查其URI是否混入了旧版驱动强加的冗余参数。例如：
错误URI：ipp://192.168.1.100/ipp/print?model=HP-LaserJet-P1106
正确URI：ipp://192.168.1.100/ipp/print
多出的 ?model=xxx 会干扰 CUPS 自动匹配 PPD 和过滤器策略，导致 filter failed。编辑打印机时，在“设备 URI”栏手动删掉问号及之后全部内容，仅保留基础协议+IP+路径。
