文章
ionCube 错误排查
为保护 WHMCS 软件代码安全，我们使用 ionCube® 系统进行混淆加密。ionCube 加载器配置不当可能导致以下错误：
错误：需安装 ionCube PHP 加载器...
排查 Duo Security 登录失败问题
问题
您或您的客户在使用 Duo® Security 进行双因素认证(2FA)时遇到错误或问题。
例如在 配置 > 系统日志 中可见：...
排查 "Access Denied - Forbidden" 错误
Access Denied - Forbidden
此错误表明受影响管理员当前分配的角色权限不足：
解决方案
前往...
排查 "Argument 1 passed... must be an instance of PDOStatement" 错误
症状
执行MySQL密集型操作时可能出现：
TypeError: Argument 1 passed to... must be an instance of...
排查 "Dataset must be an array in /vendor/whmcs/whmcs-foundation/lib/TableQuery.php" 错误
症状
查看客户/服务/附加服务/域名列表时出现：
InvalidArgumentException: Dataset must be an array in...
排查 "Duplicate entry '0' for key 'PRIMARY'" 错误
症状
迁移WHMCS数据库或恢复备份时可能出现：
PDOException: SQLSTATE[23000]: Integrity constraint...
排查 "Failed Opening Required file" 错误
症状
访问WHMCS部分功能时，您可能看到以下错误：
main(): Failed opening required...
排查 "The file /path/to/whmcs/index.php is corrupted" 错误
症状
安装、升级或使用 WHMCS 时出现：
文件 /path/to/whmcs/index.php 已损坏
(其中...
排查 "The template could not be found" 错误
症状
访问WHMCS特定页面时出现：
LogicException: The template "$filename" could not be found at...
排查 "You are currently accessing the admin area using an insecure connection" 提示
症状
访问WHMCS管理员区域时，页面顶部显示：...
排查 CURL 错误：56 - OpenSSL SSL_read 读取时出现意外的文件结束符
症状
当尝试对远程系统执行操作（例如通过 eNom 管理域名或在服务器上管理托管账户）时，您可能会看到以下错误：
CURL Error: 56 - OpenSSL...
排查 Carbon.php:425 的 "InvalidArgumentException: Data missing" 错误
症状
升级服务器环境至 PHP 7.4 后，在 帮助 > 系统健康状态 页面出现错误：
InvalidArgumentException: Data...
排查 InvalidArgumentException: Query string must not include a URI fragment 错误
症状
启用错误日志后，系统活动日志中出现：
InvalidArgumentException: Query string must not include a URI...
排查 PDF 发票/报价单显示问号问题
本文说明如何解决 PDF 格式发票或报价单中字母显示为问号的问题。
以下截图展示典型症状：
解决方案
进入 配置 > 系统设置 >...
排查 TypeError: Argument 1 passed to Carbon\CarbonInterval::setLocalTranslator() 错误
症状
升级至WHMCS v8.0+后可能出现：
TypeError: Argument 1 passed to...
排查 reCAPTCHA 网站密钥的域名无效问题
症状
所有受 reCAPTCHA 保护的区域（如客户区登录、管理区登录、结账页面等）都会显示以下错误，导致表单无法提交：
原因
只有当 WHMCS...
排查"Allowed memory size exhausted"内存溢出错误
当出现类似以下错误时，表明 WHMCS 已达服务器 PHP 内存限制：
Allowed memory size of xxxxx bytes exhausted (tried to...
排查"与服务器通信时出错"提示
症状
WHMCS 模态窗口中可能出现：
与服务器通信时出错，请重试
解决方案
▸ 系统URL不匹配
记录浏览器地址栏中的实际URL...
排查"严重错误：无法连接数据库"故障
症状
应用2020年11月3日MariaDB更新后，特定PHP环境访问WHMCS时出现：
PHP 5.6 → SQLSTATE[HY000]: 一般错误：1835...
排查"无法创建根目录"错误
症状
通过 WHMCS 发送邮件或访问 工具 > 系统 > 系统清理 时可能出现 "Oops" 错误页。
启用错误显示后可见：...
排查404页面不存在错误
症状
在导航到管理区域和客户区域的各个部分时，您可能会看到类似以下示例的错误：
示例中的 URL 生成的是 SEO...
排查双因素认证二维码无法显示问题
症状
管理员区域和客户区域的双因素认证（2FA）二维码显示为破损图片：
二维码破损示意图
解决方案
▸ 临时解决方案
使用 字母数字密钥...
排查备份错误
在 Setup > Other > Database Backups 页面点击 Test Connection 按钮时可能出现以下错误：
SFTP Backup...
故障排查：CURL错误 56 - OpenSSL SSL_read: Success错误
症状
在通过Enom管理域名或托管远程系统账户时，可能遇到以下错误：
`注册商错误
CURL Error: 56 - OpenSSL SSL_read: Success`...
Powered by WHMCompleteSolution
