Kiran 桌面报错排查与日志速查表

Kiran 桌面报错排查与日志速查表

目录

1. 常见日志位置

2. 报错场景与解决思路

3. 编译/安装报错

4. 实用命令速查

常见日志位置

模块 / 场景	日志路径	说明
用户会话日志	~/.xsession-errors	Kiran 桌面组件启动失败/崩溃时最常见
登录管理器 (LightDM)	/var/log/lightdm/lightdm.logjournalctl -u lightdm	登录黑屏/循环登录
X Server 显示服务	/var/log/Xorg.0.log	显卡驱动、分辨率、图形启动失败
桌面整体日志	journalctl -xe	系统级错误追踪
Kiran 面板 (kiran-panel)	终端运行：kiran-panel	stderr 打印错误
控制面板 (kiran-control-panel)	终端运行：kiran-control-panel	界面无法打开时排查
认证服务 (kiran-authentication-service)	journalctl -u kiran-authentication-service/var/log/secure	指纹、人脸、密码登录失败
GTK/主题相关	/usr/share/themes/	主题缺失、UI 显示异常

报错场景与解决思路

🔹 桌面启动失败 / 黑屏

• 查看 journalctl -xe 是否有 lightdm / Xorg 错误

• 确认显卡驱动是否匹配

• 检查 ~/.xsession-errors 是否有 Kiran 组件报错

🔹 登录循环

• 查看 /var/log/lightdm/lightdm.log 和 /var/log/Xorg.0.log
• 检查 .Xauthority 权限是否错误

chown 用户名:用户名 ~/.Xauthority

• 检查 PAM 配置是否被修改

🔹 面板/任务栏不显示

• 运行：

kiran-panel --replace

• 检查依赖是否安装：kiran-widgets-qt5, kiran-gtk-theme

🔹 控制面板打不开

• 运行：

  kiran-control-panel

• 查看 stderr 输出，若缺少库文件，安装对应 -devel 包

🔹 认证失败 (指纹/人脸/密码)

• 查看服务状态：

systemctl status kiran-authentication-service

• 查看 /var/log/secure 是否有 PAM 报错

• 确认设备驱动已加载

编译/安装报错

• 进入 build/ 目录查看：

  • CMakeError.log
  • CMakeOutput.log

• 常见缺少依赖：

  • qt5-qtbase-devel

  • gtk3-devel

  • dbus-devel

  • pam-devel

  • glib2-devel

安装示例：

sudo dnf install gcc gcc-c++ cmake make qt5-qtbase-devel gtk3-devel dbus-devel pam-devel glib2-devel

实用命令速查

操作	命令
查看系统整体错误	journalctl -xe
查看 lightdm 登录日志	journalctl -u lightdm
查看认证服务日志	journalctl -u kiran-authentication-service
查看最近 Xorg 报错	less /var/log/Xorg.0.log
实时追踪用户会话报错	tail -f ~/.xsession-errors