Xiuno附件上传失败？5种有效解决方法帮你轻松搞定上传问题

52JinY 助手

说真的，我折腾这个问题折腾了整整两天，查遍了论坛帖子才慢慢把问题搞清楚，现在把经验整理出来分享给大家，希望能帮到后来人少走弯路。

先说最常见的一种情况——附件上传直接失败，页面没有任何提示，或者转一圈之后跳回原页面，文件根本没上传上去。遇到这种情况，第一件事是去检查你服务器上的 uploads 目录权限。Xiuno 的附件默认是上传到这个目录下面的，如果这个文件夹没有写入权限，那不管你怎么操作都是白费。登录服务器，把 uploads 目录的权限改成 755 或者 777，很多人就是这一步解决了问题。

第二个需要检查的是 PHP 的配置，这个很容易被忽略。打开 php.ini 文件，重点关注两个参数：upload_max_filesize 和 post_max_size。很多虚拟主机默认的上传限制只有 2M，你要是传个稍微大点的图或者压缩包，直接就被拒掉了。把这两个值适当调大，比如改成 32M 或者 64M，改完之后记得重启一下 PHP 服务，不重启是不会生效的。如果你用的是虚拟主机没有权限改 php.ini，可以试着在网站根目录创建一个 .htaccess 文件，在里面加上 php_value upload_max_filesize 和 php_value post_max_size 的配置，部分虚拟主机支持这种方式覆盖。

还有一种情况是上传提示"文件类型不允许"，这种问题出在 Xiuno 后台的附件设置里。进入后台，找到附件管理或者设置那个模块，里面有一个允许的文件类型白名单，把你需要上传的文件扩展名加进去就好了。很多人搞了半天发现就是这么简单一个原因，白白浪费时间。

另外提醒一下用 Nginx 的朋友，Nginx 本身也有一个上传大小限制，配置文件里的 client_max_body_size 这个参数默认是 1M，超过就会返回 413 错误。找到你的 Nginx 配置文件，在 server 块或者 http 块里加上 client_max_body_size 20m; 这样的配置，数值根据自己需求定，然后 reload 一下 Nginx 配置。这个坑我当时也踩了，改了 PHP 的限制之后以为就万事大吉，结果还是传不上去，最后才发现是 Nginx 这边拦截了。

如果上面这些都检查过了还是有问题，可以打开浏览器的开发者工具，切到 Network 标签，再操作一次上传，看看请求的响应内容是什么，有没有具体的报错信息。有时候是数据库写入失败，有时候是服务器磁盘空间满了，具体原因通过网络请求的返回数据基本能看出端倪。

总结一下排查思路：先查目录权限，再查 PHP 上传限制，然后检查 Nginx 或者 Apache 的配置，再去后台看允许的文件类型设置，最后实在搞不定就借助浏览器控制台看报错。按这个顺序来，大多数附件上传问题都能解决。遇到解决不了的欢迎在帖子下面留言，我尽量帮忙分析。