在开发小程序的过程中，由于小程序官方要求所有接口必须通过HTTPS协议访问，因此很多开发者会选择先在本地XAMPP环境部署后端服务并完成HTTPS配置，方便调试开发。下面我们就一步步完成整个流程。
一、XAMPP环境准备与后端基础部署
首先确保已经安装好XAMPP，并且Apache服务可以正常启动。我们以PHP作为后端语言为例，将后端代码放到XAMPP的htdocs目录下，比如创建目录miniapp_backend，里面放置一个简单的接口文件test.php，代码如下：
<?php
header("Content-type: application/json; charset=utf-8");
$response = [
"code" => 200,
"msg" => "接口访问成功",
"data" => []
];
echo json_encode($response, JSON_UNESCAPED_UNICODE);
?>
此时先通过HTTP协议访问http://localhost/miniapp_backend/test.php，确认接口可以正常返回数据，再进行后续的HTTPS配置。
二、生成SSL证书
XAMPP自带了生成SSL证书的工具，我们可以通过命令行完成证书生成，步骤如下：
- 打开XAMPP安装目录下的
apache文件夹，找到conf目录下的openssl.cnf文件，记录其路径，比如D:/xampp/apache/conf/openssl.cnf - 打开系统命令行，切换到XAMPP的
apache/bin目录，执行以下命令生成私钥和证书
# 生成私钥 openssl genrsa -out server.key 2048 # 生成证书签名请求 openssl req -new -key server.key -out server.csr -config D:/xampp/apache/conf/openssl.cnf # 生成自签名证书，有效期365天 openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt
生成完成后，将server.key和server.crt两个文件移动到D:/xampp/apache/conf/ssl.crt目录下，方便后续配置引用。
三、配置Apache支持HTTPS
接下来需要修改Apache的SSL配置文件，开启HTTPS访问支持：
- 打开XAMPP安装目录下的
apache/conf/extra/httpd-ssl.conf文件 - 找到
SSLCertificateFile和SSLCertificateKeyFile两个配置项，修改为刚才生成的证书路径：
# 证书文件路径 SSLCertificateFile "D:/xampp/apache/conf/ssl.crt/server.crt" # 私钥文件路径 SSLCertificateKeyFile "D:/xampp/apache/conf/ssl.crt/server.key"
然后找到DocumentRoot配置项，将其修改为后端项目所在的目录，比如：
DocumentRoot "D:/xampp/htdocs/miniapp_backend"
<Directory "D:/xampp/htdocs/miniapp_backend">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
修改完成后保存文件，重启Apache服务，此时访问https://localhost/test.php，如果浏览器提示证书不安全（因为是自签名证书），选择继续访问，就可以看到接口返回的数据，说明HTTPS已经配置成功。
四、解决小程序接口访问问题
由于我们使用的是自签名证书，小程序在正式环境中无法信任该证书，因此如果是开发调试阶段，可以将小程序的不校验合法域名、web-view（仅调试）选项打开，具体路径为：微信开发者工具 -> 详情 -> 本地设置 -> 勾选不校验合法域名。
如果是需要正式环境使用，就需要申请正规的SSL证书，将生成的server.crt和server.key替换为正规证书对应的文件即可，其他配置步骤保持一致。
五、常见问题排查
| 问题现象 | 可能原因 | 解决方法 |
|---|---|---|
| Apache启动后SSL模块未加载 | httpd.conf中SSL模块未开启 | 打开apache/conf/httpd.conf，去掉LoadModule ssl_module modules/mod_ssl.so前的注释，同时去掉Include conf/extra/httpd-ssl.conf前的注释 |
| 访问HTTPS接口返回404 | DocumentRoot路径配置错误 | 检查httpd-ssl.conf中的DocumentRoot和实际后端项目路径是否一致 |
| 小程序调用接口提示证书错误 | 使用的是自签名证书且未开启不校验选项 | 调试阶段开启小程序的不校验选项，正式环境更换正规SSL证书 |
完成以上所有步骤后，就可以在XAMPP环境下成功部署小程序后端并配置好HTTPS接口访问，满足小程序的开发调试需求。
XAMPP小程序后端HTTPS配置Apache_SSL修改时间：2026-06-23 17:51:23