关于https真机调试与小程序发布的总结

在努力的前端小白

已于 2025-03-19 23:48:15 修改

阅读量1k

点赞数 11

文章标签：小程序 https 网络协议

于 2025-03-19 23:42:20 首次发布

本文链接：https://blog.youkuaiyun.com/m0_57731044/article/details/146382066

版权

前言

因为个人写的小程序涉及到WebSocket，所以得使用https请求，这时候就涉及到服务器、域名和SSL证书，这三个缺一不少。

1、申请服务器、域名和SSL证书

可以访问腾讯云官网：https://cloud.tencent.com/，申请个便宜点的域名，个人买的是2核2G3兆的，具体根据个人需求来，具体截图如下：

1.1、服务器申请：

1.2:、域名申请与备案

这里可以访问这个链接进行域名购买https://cloud.tencent.com/product/domain 域名注册_域名查询_域名购买_域名续费-腾讯云 https://cloud.tencent.com/product/domain，域名购买成功之后得申请备案，因为只有申请备案才可以进行SSL证书申请，个人买的下图中的域名，具体截图如下：

提示：

注意：

小程序审核一定要到小程序的官网上审核：微信公众平台

1.3、SSL证书申请

目前腾讯云有免费的SSL的证书可以申请，可参考：SSL证书免费申请流程：SSL 证书免费 SSL 证书申请流程_腾讯云，

免费证书有效期一般90天

做足这些准备基本上做小程序的发布和真机调试就没有问题了

2、真机报错中遇到的问题总结

1、报 “error“:600001,“errMsg“:“request:fail -200:net::ERR_CERT_COMMON_NAME_INVALID”

问题分析：

遇到这个错误通常是由于 SSL 证书问题引起的，尤其是证书的域名与请求的服务器不匹配。具体来说，“ERR_CERT_COMMON_NAME_INVALID”表示 SSL 证书的通用名称（CN）与请求的域名不一致。解决此问题的几个步骤如下：

1. 检查证书：
- 确保你的服务器使用的是有效的 SSL 证书，并且证书中的域名与小程序请求的域名一致。可以通过浏览器访问接口地址，检查证书详情，确认其是否有效。

2. 使用正确的域名：
- 确保微信小程序请求的 URL 地址与服务器配置的域名匹配。例如，如果你使用了 `api.example.com`，证书中也需要包括这个域名。

3.*检查证书是否过期：
- 如果 SSL 证书已经过期，可能会导致这个错误。请检查证书的有效期并确保它仍然有效。

4. 更新证书：
- 如果证书过期或者是自签名证书，考虑更换为由受信任的证书颁发机构签发的证书。

5. 确认小程序的域名设置：
- 在微信小程序的管理后台，确认你已经将正确的域名加入了 `服务器域名` 和 `请求合法域名` 白名单。

6. 检查代理/中间件配置：
- 如果你使用了代理服务器或者负载均衡等中间件，确认这些设备或配置没有引起 SSL 证书的替换或不匹配。

7. 重新启动服务器：
- 证书更新后，可能需要重启 Web 服务器才能让新的证书生效。

如果这些步骤都没有解决问题，可以尝试使用一些 SSL 调试工具（例如 [SSL Labs](https://www.ssllabs.com/ssltest/)）来进一步诊断服务器证书的问题。

2.1、检查小程序后台有没有配置

打开微信小程序，开发管理->服务器域名

2.2、注意事项

域名不能使用 IP 地址（小程序的局域网 IP 除外）或 localhost；
可以配置端口，如 https://myserver.com:8080，但是配置后只能向 https://myserver.com:8080 发起请求。如果向 https://myserver.com、https://myserver.com:9091 等 URL 请求则会失败。
如果不配置端口。如 https://myserver.com，那么请求的 URL 中也不能包含端口，甚至是默认的 443 端口也不可以。如果向 https://myserver.com:443 请求则会失败。
域名必须经过 ICP 备案；
出于安全考虑，api.weixin.qq.com 不能被配置为服务器域名，相关 API 也不能在小程序内调用。开发者应将 AppSecret 保存到后台服务器中，通过服务器使用 getAccessToken 接口获取 access_token，并调用相关 API；
不支持配置父域名，使用子域名。
服务、域名、SSL证书缺一不可，而且一定要经过备案

2.3、证书要求

HTTPS 证书必须有效；
- 证书必须被系统信任，即根证书被已系统内置
- 部署 SSL 证书的网站域名必须与证书颁发的域名一致
- 证书必须在有效期内
- 证书的信任链必需完整（需要服务器配置）重点

由上图可见，证书级别为B，提示证书链不完整。

2、“errno“:600001,“errMsg“:“request:fail -118:net::ERR_CONNECTION_TIMED_OUT“

遇到错误 errno: 600001, errMsg: request:fail -118: net::ERR_CONNECTION_TIMED_OUT 通常是由于网络连接超时问题引起的。这意味着微信小程序在尝试连接到服务器时，未能在规定时间内完成连接。以下是一些可能的原因和解决方案：

1. 检查服务器状态

服务器未响应：确保你的服务器正在正常运行，并且没有发生宕机或者重启。
检查负载和性能：如果服务器的负载过高，可能会导致请求超时。检查服务器的 CPU 和内存使用情况。

2. 网络问题

网络不稳定或慢：检查服务器和微信小程序之间的网络连接是否稳定。如果你使用的是云服务提供商，检查其服务是否正常。
防火墙/安全组配置：确认服务器的防火墙或安全组规则没有阻止微信小程序的请求，特别是确保端口 80 (HTTP) 或 443 (HTTPS) 没有被阻塞。

3. 域名解析问题

DNS 配置错误：如果使用自定义域名，确认域名解析正常。可以尝试通过 nslookup 或 dig 等工具检查域名解析是否正常。
域名解析缓存问题：有时 DNS 缓存可能会导致连接超时，尝试清理 DNS 缓存或者重新启动服务器来确保解析正常。

4. 小程序网络请求配置

超时设置问题：检查小程序中的 wx.request 配置，确保设置的 timeout 参数合理（例如 5000ms）。如果超时时间过短，可能会导致请求未完成就被终止。

wx.request({
  url: 'https://your-api-endpoint',
  timeout: 5000,  // 5秒超时
  success(res) {
    console.log(res)
  },
  fail(err) {
    console.error(err)
  }
})

5. 代理服务器或负载均衡器问题