Ubuntu 16.04 Apache2.4.18配置Git over HTTPS后认证日志报错求助

我之前也碰到过一模一样的情况——Git的clone、push都完全正常，但Apache日志里反复刷认证失败的报错，看着特别闹心。结合你Ubuntu 16.04 + Apache 2.4.18的环境，给你几个针对性的排查和解决方向：

1. 细化Apache认证规则，只针对核心Git操作路径 #

默认配置可能给整个Git仓库目录都加了认证，但实际上Git的Smart HTTP模式只需要对特定的操作端点强制认证。你可以调整Apache配置，让认证只作用于真正需要的请求：

# 先允许无认证访问基础的仓库路径和不带service参数的info/refs
<Location /git>
    Require all granted
</Location>

# 对Git的上传/下载操作端点强制认证
<LocationMatch "^/git/[^/]+/(git-upload-pack|git-receive-pack)$">
    AuthType Basic
    AuthName "Git Repository"
    AuthUserFile /path/to/your/.htpasswd
    Require valid-user
</LocationMatch>

# 对带service参数的info/refs请求也强制认证（这是Git协商阶段的关键请求）
<LocationMatch "^/git/[^/]+/info/refs\?service=git-(upload|receive)-pack$">
    AuthType Basic
    AuthName "Git Repository"
    AuthUserFile /path/to/your/.htpasswd
    Require valid-user
</LocationMatch>

修改后重启Apache：sudo systemctl restart apache2。这样只有实际的Git操作请求会触发认证，无意义的预请求或静态访问不会触发，自然就不会产生报错日志。

2. 排查Git客户端的预请求行为 #

有些旧版本的Git客户端（或者某些GUI工具，比如SourceTree、GitKraken）会先发送一个不带认证信息的GET /info/refs请求，触发401后再补发带认证的请求，这就会导致日志里出现报错。你可以：

• 升级Git到最新稳定版：Ubuntu 16.04可以通过PPA更新，执行命令：

  sudo add-apt-repository ppa:git-core/ppa && sudo apt update && sudo apt upgrade git
  

• 暂时切换到命令行执行Git操作，观察日志是否还出现报错，以此确认是不是客户端工具的问题。

3. 临时调整Apache日志级别过滤报错 #

如果前面的方法都没解决，你可以先过滤掉这些烦人的报错日志（这是治标不治本的方法，优先推荐前面的方案）。修改Apache的主配置文件/etc/apache2/apache2.conf：

# 把日志级别调整为warn，或者更精确地过滤认证模块的错误
LogLevel warn
# 或者只把认证模块的日志级别设为notice，避免错误日志刷屏
LogLevel auth_basic:notice auth_digest:notice

修改后重启Apache生效。

4. 验证密码文件的正确性和权限 #

虽然Git操作正常，但还是可以再确认一下密码文件的细节：

• 对于Basic Auth：确保.htpasswd是用htpasswd -c /path/to/.htpasswd 你的用户名生成的，并且权限设置正确（Apache需要可读）：

  sudo chmod 640 /path/to/.htpasswd && sudo chown www-data:www-data /path/to/.htpasswd
  

• 对于Digest Auth：确认.htdigest是用htdigest -c /path/to/.htdigest "Git Repository" 你的用户名生成的，配置里的AuthName要和命令里的引号内容完全一致。

5. 检查是否有冲突的Apache模块 #

Apache 2.4的新认证规则可能和旧的mod_access_compat模块冲突，你可以禁用这个模块试试：

sudo a2dismod access_compat && sudo systemctl restart apache2

另外，也要检查是否有其他虚拟主机配置或者.htaccess文件覆盖了当前的认证规则，导致不必要的认证检查。

内容的提问来源于stack exchange，提问作者SjonnieRoughwood