故障排除
本节列出了 HostMyServers WHMCS 注册商模块最常见的问题以及诊断和解决这些问题的步骤。
启用调试模式
在查找问题原因之前，先在 WHMCS 中启用调试日志：
设置 → 系统 → 注册商模块 → HostMyServers → 配置 → 调试模式：已启用
启用后，模块的每个 API 调用都会记录在 WHMCS 日志中。从以下位置访问日志：
工具 → 活动 → Registrar Log
日志条目显示发送的请求和从 HostMyServers API 收到的响应，可帮助精确识别错误来源。
调试模式会生成大量日志，可能会略微降低 WHMCS 速度。问题解决后请立即关闭。
连接问题
模块未出现在注册商列表中
症状：安装后，HostMyServers 在设置 → 注册商模块中不可见。
原因和解决方案：
- 模块文件夹名称不是精确的
hostmyservers（全小写，无连字符或空格）→ 重命名 hostmyservers.php文件缺失或位置错误 → 检查文件夹结构- 权限问题 → 对文件执行
chmod 644，对文件夹执行chmod 755 - WHMCS 缓存 → 工具 → 清除模板缓存
"连接被拒绝"错误或超时
症状：连接测试失败，出现连接错误或超时。
原因和解决方案：
- 服务器无法访问 HostMyServers API 端点 → 检查服务器出站防火墙。API 使用 443 端口（HTTPS）
- cURL 未安装或已禁用 → 使用
php -m | grep curl检查
身份验证错误（401 / 凭据无效）
症状：连接测试返回"凭据无效"或 401 错误。
原因和解决方案：
- API 标识符或 API 密钥错误 → 在 hostmyservers.fr/user/api 核实
- 沙盒模式已启用但使用了生产凭据（或反之）→ 确保模式与凭据一致
- API 密钥已在 hostmyservers.fr/user/api 删除/重建但未更新 WHMCS → 在模块配置中更新密钥
注册 / 操作问题
域名无限期停留在"待处理"状态
症状：下单后，域名始终无法切换到活跃状态。
原因和解决方案：
- 正常的异步注册（某些 TLD 需要数小时）→ 等待并强制同步
- 注册时出现静默错误 → 启用调试模式并检查日志
- 下单时余额不足 → 在 HostMyServers 客户区检查余额并充值，然后手动重新触发注册
自动续费时出错
症状：cron 触发了一次无声失败的续费。
原因和解决方案：
- 余额不足 → 充值账户并手动重新触发续费
- WHMCS 中到期日期不正确 → 运行同步以更正，然后续费
- 域名已到期超过 30 天（超出宽限期）→ 联系 HostMyServers 支持进行恢复
名称服务器未更新
症状：在 WHMCS 中修改名称服务器，HostMyServers 未反映更改。
原因和解决方案：
- 名称服务器格式无效（例如末尾有
/或空格）→ 检查输入的值 - 该 TLD 不支持通过 API 修改名称服务器 → 查阅该 TLD 的 HostMyServers 文档
- API 错误 → 启用调试并检查日志
同步问题
WHMCS 中的到期日期不正确
症状：WHMCS 中显示的到期日期与 HostMyServers 的实际日期不符。
解决方案：
- 转到工具 → 域名同步
- 运行完整同步
- WHMCS 会自动比较并更正日期
如果特定域名的问题仍然存在，请检查同步日志以识别 API 返回的错误。
同步未执行
症状：状态和日期从未自动更新。
原因：WHMCS cron 任务未配置或未运行。
解决方案：检查 cron 配置（参见自动化）。
账户问题
余额不足
如果您的 HostMyServers 余额不足，所有付费操作（注册、续费、转移）都将失败，并显示 Insufficient funds 错误。
解决方案：从 HostMyServers 客户区为账户充值。启用低余额提醒以避免此类情况。
订单待人工审核
某些订单可能被 HostMyServers 置于人工审核等待中（特别是对于特定 TLD 或异常数量）。在这种情况下，请直接联系 HostMyServers 支持。
联系 HostMyServers 支持
如果查阅本文档后仍无法解决问题：
- 记录准确的错误消息和相应的调试日志
- 记录模块版本（在
hostmyservers.php文件顶部可见） - 记录您的 WHMCS 和 PHP 版本
- 联系 HostMyServers 支持并包含这些信息
HostMyServers 支持可从您的客户区 → 支持 → 开启工单获得。