Apache 2.2升级2.4后LDAP认证失效，AH01796错误求助

我之前也踩过Apache版本升级导致认证崩溃的坑，核心原因是Apache 2.4彻底重构了认证/授权模块的体系，和2.2的依赖逻辑完全不一样。你的错误提示虽然指向AuthBasic，但根源大概率是缺少了2.4必需的配套模块，或者配置语法需要适配新版本。下面一步步帮你排查：

1. 检查是否加载了所有必需的核心模块 #

Apache 2.4把认证相关功能拆成了多个独立模块，仅加载mod_auth_basic远远不够，必须同时加载以下模块：

# 认证核心框架（AuthBasic的依赖基础）
LoadModule authn_core_module lib/modules/mod_authn_core.so
# 授权核心框架（处理require类规则的底层支持）
LoadModule authz_core_module lib/modules/mod_authz_core.so
# LDAP认证专用模块（2.4新增，替代2.2中mod_ldap的部分认证逻辑）
LoadModule authn_ldap_module lib/modules/mod_authn_ldap.so
# LDAP基础通信模块（和authn_ldap配合完成LDAP交互）
LoadModule ldap_module lib/modules/mod_ldap.so
# 如果用了AuthGroupFile，必须加载这个模块解析组文件
LoadModule authz_groupfile_module lib/modules/mod_authz_groupfile.so

你可以执行httpd -M命令查看已加载模块列表，确认上面这些模块都在输出里（注意模块名是小写的，比如authn_core_module）。

2. 调整配置适配Apache 2.4的语法 #

2.4对授权规则的语法有更严格的要求，你可以参考以下配置调整（保留你的核心LDAP参数）：

AuthType Basic
AuthName "Enter your name"
# 2.4中明确指定认证提供者顺序（ldap在前，file对应组文件）
AuthBasicProvider ldap file
# 原LDAP连接参数保持不变
AuthLDAPURL "ldaps://myldap.server/ou=People,ou=xx,DC=xx,DC=xx?sAMAccountName,cn,DN,displayName?sub?"
AuthLDAPBindDN "CN=myaccount,OU=_Service Accounts,OU=Managed Linux,OU=Servers,DC=xx,DC=xx"
AuthLDAPBindPassword xxxxxxxxx
# 组文件路径不变
AuthGroupFile /usr/local/apache/passwd/groups
# 2.4中需明确设置授权优先级
AuthBasicAuthoritative Off
# 授权规则保持原有需求
Require group Admins
# 远程用户属性设置不变
AuthLDAPRemoteUserAttribute sAMAccountName

注意：如果你的组文件里的用户是本地账号，还需要确保mod_authn_file模块也已加载。

3. 验证LDAP绑定和查询是否正常 #

先排除LDAP服务器本身的问题，用ldapsearch命令测试绑定账号能否正常查询用户：

ldapsearch -H ldaps://myldap.server \
-D "CN=myaccount,OU=_Service Accounts,OU=Managed Linux,OU=Servers,DC=xx,DC=xx" \
-w xxxxxxxxx \
-b "ou=People,ou=xx,DC=xx,DC=xx" \
"(sAMAccountName=你的测试用户名)"

如果能返回用户的属性信息，说明LDAP连接和绑定账号没问题；如果报错，需要先排查LDAP服务器的访问权限、ldaps证书有效性等问题。

4. 重启Apache并检查日志 #

调整完模块和配置后，执行service httpd restart（或systemctl restart httpd）重启服务，然后查看错误日志（通常在/var/log/httpd/error_log）。如果还有错误，再根据新的提示进一步排查——比如如果提示找不到组，可能需要检查AuthGroupFile的格式是否正确（格式为组名: 用户1 用户2 ...）。

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