如何修复XAMPP证书错误， 让ID匹配服务器名称，是一招解决

在使用XAMPP进行本地开发时许多用户都会遇到这样一个警告信息：

这条消息虽然不会直接影响Apache的启动或网站访问，但它表明您的SSL配置中存在“服务器名称与证书ID不匹配”的问题。长期忽略可能导致平安隐患或HTTPS连接异常。

什么是“服务器证书不包含与服务器名称匹配的ID”错误？

该错误指的是当前Apache所使用的SSL证书中，定义的域名和您在Apache配置文件中指定的服务器名称不一致。简单就是访问地址和证书上的域名不匹配。

举个例子：

• Apache配置文件中指定：ServerName localhost
• 但SSL证书上CN为：www.example.com

此时Apache就会发出上述警告。

XAMPP中为何会出现该错误？

XAMPP内置了默认自签名证书， 通常使用 www.example.com 或者其他默认域名作为证书的通用名，而本地开发时我们多数通过 localhost, 或者局域网IP访问。所以呢实际访问地址和证书域名不符，就产生了这个警告。

需要留意的是：这种情况多见于本地测试环境， 不影响功能正常运行，只是平安层面提示您配置应更合理。

修复该错误前要准备什么？

• XAMPP已安装并能正常启动Apache模块；
• 有文本编辑器， 如Notepad++、VSCode等；
• XAMPP所在目录路径；
• 基本操作权限，能够修改文件及重启服务；
• 自行生成或导入新的SSL证书；但本文主要针对默认自签名情况；

XAMPP修复步骤详解：让ID匹配服务器名称，一招搞定！

第一步：打开XAMPP控制面板定位相关文件夹

- 启动XAMPP控制面板

- 点击右侧"Explorer"按钮， 会打开XAMPP安装目录，一般是 C:\xampp\apache\conf\extra\

第二步：找到并编辑httpd-ssl.conf文件中的ServerName配置项

- 在上述目录下找到httpd-ssl.conf, 此文件专门管理Apache SSL设置。

- 用文本编辑器打开该文件，比如Notepad++。

# 查找类似以下内容：
# ServerName www.example.com:443
# 修改为：
ServerName localhost:443
# 注意要取消注释，确保只有一处生效。

*说明： 这里将ServerName改为“localhost”， 使其与您本地访问时使用的主机名相同，从而解决“ID与服务器名称不匹配”问题。如果您使用局域网IP或其它自定义主机名，请替换成对应值。

第三步：保存修改并重启Apache服务以应用更改

• - 回到XAMPP控制面板，点击"Stop", 停止 Apache 服务。
• - 等待几秒钟，再点击"Start", 重启 Apache 服务。
• - 如果启动成功且无新的警告，说明配置已生效。

补充说明：查看并验证日志确认是否修复成功

• - 点击XAMPP控制面板中的"Logs"选择"Apache " ;查看最新日志条目是否仍有AH01909警告。
• - 若无此警告，则代表已修复。若依旧存在则需检查是否正确保存修改，并确保无多个conf文件相互冲突。
• - 建议清理浏览器缓存或者尝试新浏览器重新访问本地站点进行测试。
• - 一边确认浏览地址是否为您在ServerName中设置的一致。

XAMPP生成自定义SSL证书防止此类问题

*如果您想彻底避免此类问题， 还可以自己生成符合您本地主机或自定义域名的自签名SSL证书，替换默认自带的。

1. 进入 XAMPP apache 的 ssl 文件夹：C:\xampp\apache\conf\ssl.crt 和 ssl.key 。备份原有 cert 和 key 文件。
2. 使用 OpenSSL 工具生成新的密钥和自签署证书：

openssl req -newkey rsa:2048 -nodes -keyout server.key -x509 -days 365 -out server.crt
-- 在交互式界面填写 Common Name ，请填写 "localhost" 或您的真实域名。
-- 完成后得到 server.key 和 server.crt 文件。

3. 将新生成文件替换 XAMPP 对应位置：
   • C:\xampp\apache\conf\ssl.key\server.key 替换为新密钥；
   • C:\xampp\apache\conf\ssl.crt\server.crt 替换为新证书;
   • *注意备份原始文件， 以防万一恢复用；
   • *确保 httpd-ssl.conf 中引用路径正确，如：

     SSLCertificateFile "conf/ssl.crt/server.crt"
     SSLCertificateKeyFile "conf/ssl.key/server.key"
         

   • \* 重启 Apache 服务使更改生效。

     ---

     **
     • XAMPP报错“服务器证书不包含与服务器名称匹配的ID”， 主要因ID即SSL证书上的域名，与配置中的ServerName不同步导致；这是常见且温和的问题，不影响服务正常运行，但建议及时处理以避免潜在风险； 推荐方法是在xampp/apache/conf/extra/httpd-ssl.conf中，将ServerName改为与你访问地址一致，如localhost。 如需完美解决，可自行生成合适的自签署SSL，并替换默认认证。
     • XAMPP操作流程简洁明了 只需定位到对应配置文件，修改后重启即可完成。 XMAPP官方文档及社区也提供丰富指导支持：https://www.apachefriends.org/index.html 建议开发者保持环境干净整洁，及时排查日志防范其他潜在隐患。 \*如有疑问欢迎留言交流。\*

     ---

     祝你顺利解决XAMPP “服务器证书不包含与服务器名称匹配的ID” 警告！享受稳定流畅的本地开发体验！ 🚀🚀🚀