mirror of
https://github.com/kuaifan/dootask.git
synced 2026-08-01 10:55:59 +00:00
75 lines
2.3 KiB
Markdown
75 lines
2.3 KiB
Markdown
---
|
|
id: electron-client.logs.faq
|
|
title: 桌面端日志在哪 / 闪退排查
|
|
type: faq
|
|
feature: electron-client
|
|
scope: end-user
|
|
locale: zh
|
|
aliases:
|
|
- 桌面端日志
|
|
- 客户端崩溃
|
|
- 桌面端闪退
|
|
- 客户端打不开
|
|
- 客户端报错
|
|
- 日志路径
|
|
- log 在哪
|
|
- 客户端卡死
|
|
related_tools: []
|
|
related_pages: []
|
|
prerequisites: []
|
|
negative:
|
|
- 日志文件存在用户目录的应用日志路径下,客户端不内嵌日志查看器
|
|
- 没有「一键导出诊断包」功能,需要用户手动取日志
|
|
- 业务侧错误(发消息失败、接口超时)写在主进程日志,而非渲染进程
|
|
last_verified: v1.7.90
|
|
---
|
|
|
|
# 桌面端日志在哪 / 闪退排查
|
|
|
|
## 问题
|
|
DooTask 桌面端启动后白屏、闪退、卡死,需要查看日志判断原因。
|
|
|
|
## 日志路径
|
|
桌面端使用 `electron-log` 写日志,默认路径(`app-name` 为 `DooTask`):
|
|
|
|
- **macOS**:`~/Library/Logs/DooTask/main.log`
|
|
- **Windows**:`%USERPROFILE%\AppData\Roaming\DooTask\logs\main.log`
|
|
- **Linux**:`~/.config/DooTask/logs/main.log`
|
|
|
|
主要日志文件:
|
|
- `main.log`:主进程 + 业务事件(网络、更新、托盘、IPC)
|
|
- `renderer.log`:渲染进程(网页内)异常(部分版本)
|
|
- 历史日志会按大小滚动归档为 `main.old.log` 等
|
|
|
|
## 常见原因与排查
|
|
|
|
### 1. 启动直接闪退
|
|
- 检查日志末尾是否有 `JavaScript exception` 或 `Uncaught`
|
|
- 升级 / 降级到对应系统兼容的版本([[electron-client.platforms.concept]])
|
|
- macOS 13 之前的旧系统可能不兼容 Electron 38
|
|
|
|
### 2. 白屏 / 卡在 loading
|
|
- 多半是无法连接服务器
|
|
- 临时退出 → 启动前先确认浏览器能打开服务器域名
|
|
- 检查 [[electron-client.proxy.concept]] 代理设置
|
|
|
|
### 3. 收不到通知 / 没有红点
|
|
- 见 [[electron-client.notify.concept]] 的授权排查
|
|
- 日志搜 `notification` 关键字
|
|
|
|
### 4. 更新失败
|
|
- 日志搜 `update` 关键字看 `electron-updater` 报错
|
|
- 通常是更新源不可达,改用 [[electron-client.update.howto]] 手动升级
|
|
|
|
## 提交反馈
|
|
向开发 / 运维提反馈时附上:
|
|
1. `main.log` 最后 200 行
|
|
2. 系统版本、客户端版本(关于页查看)
|
|
3. 复现步骤
|
|
4. 截图(若是 UI 问题)
|
|
|
|
## 不支持
|
|
- 客户端 UI 不内嵌日志查看 / 上传(需用户手动取文件)
|
|
- 日志不会自动上传到服务器(隐私考虑)
|
|
- 不支持远程实时日志(只能事后分析)
|