FreeScout 文件上传大小限制问题排查指南

在使用FreeScout客服系统时，用户可能会遇到文件上传大小限制的问题。本文将详细介绍如何排查和解决这类问题。

问题现象

当尝试上传超过2MB的文件到FreeScout会话中时，系统会报错并拒绝上传。虽然用户已经修改了php.ini中的upload_max_filesize和post_max_size参数为30M，但系统仍然保持2MB的限制。

根本原因

经过排查发现，问题出在用户修改了错误的php.ini文件。FreeScout运行时所使用的PHP配置文件与实际修改的文件不一致，导致配置变更未生效。

解决方案

1. 确认正确的php.ini位置：

   • 通过创建phpinfo.php文件查看当前PHP配置
   • 查找"Loaded Configuration File"项确定实际使用的php.ini路径

2. 修改关键参数：

   • upload_max_filesize = 30M
   • post_max_size = 32M (建议比upload_max_filesize稍大)
   • memory_limit也应相应增加

3. 重启Web服务：

   • 修改后必须重启Apache或Nginx服务使配置生效

4. 验证配置：

   • 再次查看phpinfo确认参数已更新
   • 检查FreeScout系统管理界面是否显示新的限制值

最佳实践

1. 对于生产环境，建议通过.htaccess或Nginx配置额外设置上传限制
2. 考虑使用分块上传技术处理大文件
3. 定期检查PHP配置，确保与系统需求匹配

注意事项

• 不同PHP运行模式(FPM/CGI/CLI)可能使用不同的ini文件
• 容器化部署时需要注意配置文件挂载位置
• 云环境可能需要通过控制面板修改参数

通过以上步骤，可以彻底解决FreeScout文件上传大小限制问题，确保系统能够处理预期的文件大小。