跳到主要内容

安装问题

模块上传失败​

问题： 模块 zip 文件无法通过 Perfex 管理面板上传。

原因和解决方案：

原因解决方案
文件大小超过 PHP 上传限制在 php.ini 中将 upload_max_filesize 和 post_max_size 增加到至少 64M
上传过程中服务器超时在 php.ini 中将 max_execution_time 增加到 300
权限问题检查 modules/ 目录是否可写（chmod 755）

替代方法： 通过 FTP/SFTP 上传：

  1. 在您的计算机上解压 zip 文件
  2. 将解压后的文件夹上传到 your-perfex/modules/
  3. 通过管理面板中的 Setup → Modules 激活

上传后模块未显示​

问题： 您上传了模块，但它未出现在 Setup → Modules 中。

解决方案：

  1. 确保文件夹结构正确：modules/saas/（不是 modules/saas-module/ 或 modules/saas/saas/）
  2. 检查所有文件是否完整上传（比较文件数量）
  3. 清除浏览器缓存并刷新页面
  4. 检查文件权限：整个 modules/saas/ 目录应对 Web 服务器可读

MySQL 验证失败​

问题： 点击"Click here to verify server settings"显示错误。

错误："Access denied for user"​

原因： MySQL 用户名或密码错误。

修复方法：

  1. 仔细检查您的 MySQL 凭据
  2. 如果使用 cPanel，尝试使用 cPanel 用户名和密码
  3. 手动测试凭据：
mysql -u your_username -p -h localhost
# Enter your password when prompted
# If you can log in, the credentials are correct

错误："Can't connect to MySQL server"​

原因： MySQL 未运行或主机/端口错误。

修复方法：

  1. 检查 MySQL 是否运行：sudo systemctl status mysql
  2. 验证主机是否正确（通常是 localhost）
  3. 验证端口是否正确（通常是 3306）
  4. 如果 MySQL 在不同的服务器上，使用该服务器的 IP 地址

错误："CREATE command denied"​

原因： MySQL 用户没有创建数据库的权限。

修复方法：

-- Log in to MySQL as root:
GRANT ALL PRIVILEGES ON *.* TO 'your_username'@'localhost' WITH GRANT OPTION;
FLUSH PRIVILEGES;

或在 cPanel 中：前往 MySQL Databases → User Privileges → 勾选"ALL PRIVILEGES"

激活后白屏​

问题： 激活模块后看到空白白屏。

解决方案：

  1. 检查 PHP 错误日志： 查看 /var/log/apache2/error.log（Apache）或 /var/log/nginx/error.log（Nginx）
  2. 临时启用错误显示： 在 .htaccess 或 index.php 中添加： 
    ini_set('display_errors', 1);
    error_reporting(E_ALL);
  3. 检查 PHP 版本： 确保运行 PHP 7.4 或更高版本
  4. 检查内存限制： 在 php.ini 中设置 memory_limit = 256M

注册表单未显示​

问题： 落地页未显示注册表单。

解决方案：

  1. 确保您已在 SaaS Management → Plans 中创建了至少一个计划
  2. 检查在 SaaS Management → SuperAdmin Settings → Tenants Settings 中注册是否已 启用
  3. 验证 Landing Page Settings 中的落地页 URL 是否正确
  4. 尝试选择不同的落地页模板
  5. 清除浏览器缓存

邮件未发送​

问题： 欢迎邮件、验证邮件或发票邮件未发送。

解决方案：

  1. 在 Perfex CRM 中配置 SMTP：前往 Setup → Email → Email Settings
  2. 推荐的 SMTP 服务：
    • Gmail SMTP（免费，每天最多 500 封邮件）
    • SendGrid（免费层：每天 100 封邮件）
    • Mailgun（免费层：每月 5,000 封邮件）
  3. 从 Setup → Email → Send Test Email 测试邮件发送
  4. 检查垃圾邮件文件夹——邮件可能被标记为垃圾邮件
信息

SMTP 至关重要！ 如果未配置 SMTP，您的平台将不会发送任何邮件——包括验证邮件、欢迎邮件和发票。请首先设置此项！

租户数据库未创建​

问题： 租户注册了但其数据库未创建。

解决方案：

  1. 在 SaaS 设置中验证 MySQL 凭据（点击验证按钮）
  2. 检查 MySQL 用户是否有 CREATE DATABASE 权限
  3. 如果在共享主机上，检查是否已达到数据库限制
  4. 检查 SaaS 活动日志了解错误详情
  5. 检查 PHP 错误日志了解 MySQL 特定错误

"Maximum database connections" 错误​

问题： 数据库连接过多错误。

解决方案：

  1. 在 my.cnf 中增加 MySQL 的 max_connections： 
    [mysqld]
    max_connections = 200
  2. 重启 MySQL：sudo systemctl restart mysql
  3. 如果租户较多，考虑优化服务器（增加 RAM）
提示

问题解决了？ 如果仍有问题，请查看域名和 DNS 问题或联系支持。