OpenClaw 常见问题解答 FAQ
在使用OpenClaw广告分发系统的过程中，用户经常会遇到各种问题。本文汇总了最常见的问题及解决方案，帮助快速排查和解决使用中遇到的障碍。
一、安装与启动问题
Q1: 安装后访问后台提示404错误
A: 检查以下几点：①确认Nginx配置中root路径指向正确的OpenClaw目录；②检查index.php是否存在；③确认.htaccess文件存在且Nginx已配置try_files规则；④检查PHP-FPM是否正常运行（systemctl status php-fpm）。
Q2: 登录后台提示数据库连接失败
A: 检查config/database.php中的数据库配置：主机名、端口（默认3306）、数据库名、用户名和密码是否正确。在服务器上手动执行mysql -u 用户名 -p 验证能否连接。
Q3: 上传文件时提示权限不足
A: 执行以下命令修复目录权限：chmod -R 755 /var/www/openclaw，chown -R www-data:www-data /var/www/openclaw/storage。
二、广告投放问题
Q4: 广告不展示，请求返回空内容
A: 按以下步骤排查：①确认广告位ID是否正确；②检查广告活动状态是否为”运行中”；③查看广告位的定向规则是否过于严格导致无匹配广告；④检查当日预算是否已耗尽；⑤查看OpenClaw日志文件（logs/app.log）中的错误信息。
Q5: 广告点击数据异常增多
A: 可能遭遇点击欺诈。检查反作弊配置：①进入后台”反作弊”->”规则设置”，确认IP频率限制已开启；②查看”可疑流量”报告，识别异常来源；③临时将可疑IP段加入黑名单；④联系广告主暂停高风险流量来源。
Q6: 广告图片不显示，提示CDN错误
A: 检查CDN配置：①确认CDN域名已正确解析；②检查对象存储Bucket的访问权限是否设为公读；③清除CDN缓存后重试；④检查图片URL是否包含正确的存储路径。
三、性能问题
Q7: 后台访问非常缓慢
A: 常见原因及解决方案：①开启OPcache（php.ini中设置opcache.enable=1）；②检查数据库慢查询日志，优化查询效率；③为高频查询的字段添加索引；④增加PHP内存限制（memory_limit=256M）；⑤使用Redis缓存频繁读取的配置数据。
Q8: API接口响应超时
A: 检查：①PHP执行时间限制（max_execution_time）是否过短；②Nginx的proxy_read_timeout是否足够；③数据库连接池是否耗尽；④是否存在死锁（SHOW PROCESSLIST查看）。
四、数据统计问题
Q9: 报表数据与实际不符
A: 可能的原因：①时区设置不一致（PHP时区、MySQL时区、服务器时区需统一）；②数据同步任务（cron job）未正常执行；③广告请求日志丢失（检查磁盘空间是否充足）。
Q10: 无法导出报表Excel
A: 检查PHP是否安装了phpspreadsheet所需的扩展（php-zip、php-xml）；检查服务器临时目录的写入权限；对于大数据量导出，增加PHP超时时间并考虑异步导出方案。
五、升级与维护问题
Q11: 升级后系统报错
A: 升级标准流程：①升级前备份数据库和文件；②先在测试环境验证升级包；③按照升级文档执行数据库迁移脚本（php artisan migrate）；④清除缓存（php artisan cache:clear）；⑤若升级失败，立即从备份恢复。
六、总结
遇到问题时，首先查看日志文件（logs/app.log、nginx错误日志、PHP错误日志），日志通常包含问题的直接线索。如果问题仍然无法解决，可以携带详细日志向社区或技术支持寻求帮助。