故障排查

安装

  • 错误描述:../gosrc/src/github.com/gogs/gogs/cmd/cert.go:79: undefined: elliptic.P224
  • 可能原因:Go 语言的 RHEL/CentOS 官方发行版中因专利问题移除了相关加密算法的代码
  • 解决方案:从 golang.org/dl 下载安装 Go 语言

SSH

SSH 链接挂起 60 秒

  • 可能原因:Gogs 会在每次 SSH Push 完成之后请求自身的 Web 服务,您的防火墙或服务器提供商未允许该操作

Update 钩子指向错误的二进制路径

  • 可能原因:您升级 Gogs 后将其移动到了和之前安装位置不同的目录
  • 解决方案:到管理员控制面板(/admin)执行以下操作:
    • 重新生成 '.ssh/authorized_keys' 文件
    • 重新同步所有仓库的 pre-receive、update 和 post-receive 钩子

推送成功但控制面板没有活动更新

可能原因

在使用 SSH 推送时,Gogs 依赖通过执行钩子脚本(Hook Script)来更新仓库和最近活动。但出于某种原因,执行脚本的权限被拒绝了,尤其是在使用挂载(Mount)设备时。

解决方案
  • 请确保挂载设备时没有启用 noexec 选项,必要时需要明确指定 exec 选项。
  • 如果使用 vfat(或者 cifs)类型的挂载,请确保 uidgidfmask 选项允许运行 Gogs 的用户在挂载设备上执行脚本。
  • 如果使用网络类型的挂载,请确保服务器(NFS 或 Samba)没有禁止远程文件系统的执行脚本权限。

Git

公钥使用冲突

  • 错误描述:
    • fatal: 'XX/XX.git' does not appear to be a git repository
    • 推送代码提交后依旧显示为空仓库
  • 可能原因:~/.ssh/authorized_keys 文件中存在重复的 SSH 密钥,可能是由于您曾经或正在通过同一个系统用户使用 GitLab。
  • 解决方案:删除除了属于 Gogs 自动添加以外的所有密钥。

Gogs 无法调用 ‘git’ 命令

  • 错误描述:repo.NewRepoContext(fail to set git user.email):
  • 可能原因:该错误会发生在 Windows 安装 Git Bash 时未启用 cmd 选项。
  • 解决方案:重装并启用 cmd 选项。

Cache

  • 错误描述:cache: unknown adaptername "memcache" (forgotten import?)
  • 可能原因:为了减少不必要的导入,您需要使用构建 tags 来启用某个缓存适配器。
  • 解决方案:
    • 下载:go get -tags memcache github.com/gogs/gogs
    • 构建:go build -tags memcache
    • 如果要启用 redis 也是一样的步骤。

数据库

使用错误的 MySQL 存储引擎

  • 错误描述:Error 1071: Specified key was too long; max key length is 1000 bytes

  • 可能原因:这是由于数据库引擎为 MyISAM 导致的。

  • 解决方案:在使用 config/mysql.sql 创建完数据库后,进入数据库然后执行:

      use gogs;
      set global storage_engine=INNODB;

最后,访问 http://localhost:3000/install 即可(感谢 @linc01n)。

过时的 MySQL 密码设置

  • 错误描述:Database setting is not correct: This server only supports the insecure old password authentication. If you still want to use it, please add 'allowOldPasswords=1' to your DSN. See also https://github.com/go-sql-driver/mysql/wiki/old_passwords
  • 可能原因:只更新了 @localhost 的密码,但 @% 用户依旧使用旧密码
  • 解决方案:GitHub 讨论

连接到错误的 SQLite3 数据库

  • 错误描述:推送仓库显示仓库所有者(Owner)未注册或 user 数据表不存在。
  • 可能原因:您以服务形式启动 Gogs 的时候,Gogs 可能会使用和您预期所不同的 SQLite3 数据库文件。
  • 解决方案:使用绝对路径配置 SQLite3 数据库文件路径。

邮件服务

Windows

  • 错误描述:
2014/09/18 15:04:40 [repo.go:115 CreatePost()] [E] CreatePost: initRepository: initRepository(git clone): cygwin warning:
MS-DOS style path detected: C:\Users\user\gogs-repositories\unos\test3.git/.git
Preferred POSIX equivalent is: /cygdrive/c/Users/user/gogs-repositories/unos/test3.git/.git
CYGWIN environment variable option "nodosfilewarning" turns off this warning.
Consult the user's guide for more details about POSIX paths:
http://cygwin.com/cygwin-ug-net/using.html#using-pathnames
Cloning into 'C:\Users\user\AppData\Local\Temp\484264900'...
fatal: '/cygdrive/d/svnroot/research/gogs/C:\Users\user\gogs-repositories\unos\test3.git' does not appear to be a git repository
fatal: Could not read from remote repository.
  • 可能原因:您在系统中安装了另一种命令行工具,并且与系统默认的 CMD 有不同路径风格。
  • 解决方案:请您尝试用默认的 CMD 启动 Gogs。

  • 错误描述:Resource interpreted as Stylesheet but transferred with MIME type application/x-css
  • 可能原因:Windows 注册表中错误的值
  • 解决方案:在注册表中找到 HKEY_CLASSES_ROOT 下的 .css,并将其 Content Type 的值修改为 text/css

其它

  • 错误描述:页面响应非常慢,但是显示在页面底部的时间正常(低于 100 毫秒)。
  • 可能原因:这可能是由于 Nginx 尝试通过 IPv6 的方式解析 IPv4 的地址。
  • 解决方案:显式的使用 127.0.0.1 作为主机名而不是 localhost

  • 错误描述:Error 1062: Duplicate entry 'Unknown-Mac' for key 'UQE_public_key_name'
  • 可能原因:这是由于遗留代码导致的,public_key 表之前含有唯一索引 UQE_public_key_name
  • 解决方案:您只需删除它即可。

  • 错误描述:GLIBC_2.14 not found
  • 解决方案:尝试 sudo apt-get -t testing install libc6-dev

  • 错误描述:[Macaron] PANIC: session(start): mkdir data: permission denied
  • 可能原因:Gogs 会在程序所在目录创建 data 子目录。
  • 解决方案:确保 Gogs 具有在相同目录创建子目录的权限。
最后编辑: kuteng  文档更新时间: 2023-05-05 15:02   作者:kuteng