Ubuntu Compton故障排查方法

Ubuntu 下 Compton 故障排查指南

一 快速定位与最小复现

• 在终端前台运行并观察输出，便于直接看到报错与告警：
  compton --config ~/.config/compton.conf
  若配置有误，Compton 会立即在终端打印错误信息。
• 提高日志级别并持久化输出，便于回溯：
  compton --config ~/.config/compton.conf --verbose --log-level debug 2> compton.log 1>&2
  常用日志级别：critical、error、warning、info、debug。
• 排除扩展兼容性问题：
  compton --config ~/.config/compton.conf --no-damage
• 切换渲染后端以验证驱动/兼容性差异：
  compton --config ~/.config/compton.conf --backend glx
  或
  compton --config ~/.config/compton.conf --backend xrender
• 确认进程状态与快速重启：
  pgrep -x compton || echo “未运行”
  pkill -x compton && compton --config ~/.config/compton.conf
  以上步骤能快速判断是配置问题、扩展/驱动问题还是后端问题。

二 配置与日志检查

• 配置文件路径与语法：
  常见路径为 ~/.config/compton.conf 或 /etc/xdg/compton.conf。若怀疑配置导致启动失败，先以最小配置启动（甚至不带配置文件），再逐项恢复选项定位问题：
  compton --config ~/.config/compton.conf
• 查看系统级日志，聚焦与 Compton 相关的错误：
  journalctl -xe | grep -i compton
• 查看 Compton 自身输出：
  若在前台运行或已重定向到文件（如 compton.log），直接检查文件末尾的错误与警告行。
• 若你使用 systemd 管理 Compton，检查服务状态与日志：
  systemctl status compton.service
  journalctl -u compton.service -b
  以上有助于从“配置语法—系统日志—服务状态”三维定位问题。

三 常见症状与对应处理

• 循环登录、黑屏、分辨率异常：多与显卡驱动相关。可在恢复模式或 TTY 中卸载并重装驱动，或使用 ubuntu-drivers 自动安装合适驱动：
  sudo ubuntu-drivers autoinstall
  若需临时进入系统排查，可在 GRUB 启动项末尾添加 nomodeset 启动。
• 高 CPU/内存占用或间歇性崩溃：
  1）用 top/htop 观察占用；2）更新系统与 Compton；3）切换后端（glx/xrender）；4）精简配置（先关闭阴影、模糊、透明等特效再逐项恢复）。
• 特定应用/桌面环境兼容性：
  尝试禁用 XDamage（–no-damage）、更换 backend，或在受影响的程序/工作区单独禁用/启用 Compton 进行对比测试。
• 启动失败但无明显提示：
  以最小配置前台运行，逐步恢复段落；同时检查系统日志与 Compton 输出日志，优先关注首条报错。
  以上措施覆盖了驱动、资源、兼容性与配置四个主因的常见处置路径。

四 使用 Systemd 管理时的要点

• 创建或修正服务单元（示例）：
  sudoedit /etc/systemd/system/compton.service
  写入：
  [Unit]
  Description=Compton Window Composer
  After=xorg.service

  [Service]
  ExecStart=/usr/bin/compton --config /etc/compton.conf
  Restart=on-failure
  Environment=XDG_RUNTIME_DIR=/run/user/%U

  [Install]
  WantedBy=graphical-session.target
  说明：使用 graphical-session.target 更贴合会话启动时机；如你的系统会话单元命名不同，请按实际调整。

• 使配置生效并验证：
  sudo systemctl daemon-reload
  sudo systemctl --user enable --now compton.service
  systemctl --user status compton.service
  journalctl --user -u compton.service -b

• 若你之前以系统级服务运行，建议改用用户级服务，避免会话未就绪导致的启动失败。
  以上做法可提升自启动的可靠性，并便于通过 systemd 日志定位问题。

五 仍未解决时的有效求助信息

• 准备并附带以下关键信息，便于他人复现与定位：
  1）Compton 版本与安装方式：compton --version 与 apt policy compton；
  2）显卡与驱动：lspci -nnk | grep -iA3 vga 与 ubuntu-drivers devices；
  3）最小复现步骤与配置文件（去除敏感信息）；
  4）相关日志片段：journalctl -u compton.service -b 与 compton 前台/重定向日志的最后 50 行。
• 若怀疑是已知问题，可在相关项目的 issue 跟踪中搜索相同现象与关键词。
  完备的复现与日志能显著提升问题解决效率。