跳至主要内容
版本: 1.22.3

支持选项

错误报告

如果您发现错误,请 在 GitHub 上创建问题

注意

在寻求支持时,最好准备好以下信息,以便帮助您的人员获得所需的所有信息

  1. 您的 app.ini(根据需要删除所有敏感数据)。
  2. 您看到的任何错误消息。
  3. Gitea 日志以及与该情况相关的所有其他日志。
    • 收集 trace/debug 级别的日志更有用(请参阅下一节)。
    • 使用 systemd 时,使用 journalctl --lines 1000 --unit gitea 收集日志。
    • 使用 docker 时,使用 docker logs --tail 1000 <gitea-container> 收集日志。
  4. 可重复的步骤,以便其他人可以更快速、更容易地重现和理解问题。
  5. 如果您遇到缓慢/挂起/死锁问题,请在问题发生时报告堆栈跟踪。转到“站点管理员” -> “监控” -> “堆栈跟踪” -> “下载诊断报告”。

高级错误报告技巧

日志的更多配置选项

默认情况下,日志以 info 级别输出到控制台。如果您需要设置日志级别和/或从文件收集日志,您只需将以下配置复制到您的 app.ini(删除所有其他 [log] 部分),然后您将在 Gitea 的日志目录中找到 *.log 文件(默认:%(GITEA_WORK_DIR)/log)。

; To show all SQL logs, you can also set LOG_SQL=true in the [database] section
[log]
LEVEL=debug
MODE=console,file

通过命令行收集堆栈跟踪

Gitea 可以使用 Golang 的 pprof 处理程序和工具链来收集堆栈跟踪和其他运行时信息。

如果 Web UI 停止工作,您可以尝试通过命令行收集堆栈跟踪

  1. 设置 app.ini

    [server]
    ENABLE_PPROF = true
  2. 重启 Gitea

  3. 尝试触发错误,当请求卡住一段时间后,使用 curl 或浏览器访问:http://127.0.0.1:6060/debug/pprof/goroutine?debug=1 获取堆栈跟踪。