迅睿CMS文件上传失败？过来人带你梳理常见排障方法

为啥你总能遇上迅睿CMS文件上传失败？

我前两年做企业站的时候，就把迅睿CMS当自己开小卖部的看店伙计，结果每次上新货（传文件），都被迅睿CMS文件上传失败这事儿卡脖子，就好比你进了一堆网红爆款零食，快递堵在小区门进不来，客人都站柜台催你了，你急得抠手都没用。前前后后我踩了快半个月的坑，啥离谱情况都遇上了，今天给你们唠明白，都是过来人踩过的坑，你们直接抄作业就行，不用再自己瞎摸撞南墙。

头号常见坑：“快递超重塞不下”——文件大小超限

这事儿是迅睿CMS文件上传失败排行榜第一名，占了快一半的情况，啥意思呢？就好比快递柜最大只能放20寸的箱子，你扛个28寸的行李箱往里面塞，塞得进去才怪。咱们服务器PHP环境默认的上传大小一般才2M，你传个高清banner图都不止2M，更别说传主题包、压缩包了，这不直接触发预警，给你报迅睿CMS文件上传失败么？

解决起来超简单，改俩地方就行：

• 第一改PHP配置文件php.ini，找到两个参数改成你需要的大小，比如你要传10M以内的文件就这么写： ``` upload_max_filesize = 10M post_max_size = 10M ``` 改完重启一下php服务就行，用宝塔面板的话直接在面板的php设置里就能改，不用找文件，超方便。
• 第二改迅睿CMS后台的限制：打开系统设置->上传配置->找到允许上传大小，改成和php对应的数值就行。

我跟你说，百分之三十的迅睿CMS文件上传失败到这就直接好了，就好比给快递换了个大货车拉货，直接就进门了，多大的货都能装，这不就完事了？咱就是说，只要规则调对，啥坎都能过去，勤劳的打工人什么问题解决不了！

二号坑：“保安不让进”——存储目录权限不对

这个坑多半出现在刚装完程序或者刚迁完站的时候，还是用小卖部的比喻哈：你让伙计把货放到后院仓库，结果后院仓库门锁了，伙计拿不到钥匙，放不进去货，可不就给你报迅睿CMS文件上传失败么？对应到技术上就是Linux服务器给你的upload存储目录默认开了只读权限，不让程序写文件，可不就传不上去么。

解决也简单，直接给你的根目录下的upload文件夹设置755权限就行，特殊情况实在不行再用777，用完记得改回755，安全第一。用ftp的话右键改权限，用宝塔的话点一下文件夹权限直接填数值，两三秒的事儿。我第一次遇到这个问题的时候，还以为是我程序下坏了，重新装了三遍，折腾一下午，最后发现就改个权限的事儿，尴尬得我当天多吃了三碗猪脚饭压惊，害！咱就是说，细节抓好，少饿肚子多省时间，这不比啥都强！

三号坑：“地址写错送错地方”——存储路径配置错了

这个坑大部分出现在迁站、换域名、加第三方存储之后，啥意思呢？你本来要把货放到城东仓库，结果地址写成城西，快递找不到地方，直接给你退回来，可不就是迅睿CMS文件上传失败么？

很多小伙伴迁站完只改了域名，忘了改迅睿CMS的上传存储路径，原来的路径在新服务器上不存在，文件夹都没有，程序往哪存？还有用第三方存储比如阿里云OSS、腾讯云COS的朋友，复制密钥的时候多带个空格、选错了存储区域，那肯定连不上服务器，传啥都失败。我之前就踩过这个坑，复制密钥多带了一个空格，硬生生卡了我一天，每次都是迅睿CMS文件上传失败，最后删掉那个空格立马就好，说出来你都想笑，这种细节坑真的防不胜防。

解决方法也给你写清楚：先看本地存储，根目录有没有upload文件夹，没有就新建一个，再去后台核对存储路径对不对；用第三方存储的话，重新核对一遍密钥、存储区域、bucket名称，别带多余的空格符号，完了再试一遍，基本就没问题了。细节决定成败，咱多检查一分钟，少掉十根头发不香吗？

偏门冷门坑：“当成违禁品扣了”——文件后缀没开权限

最后说个不常见但遇上就烦的，你要传zip主题包、svg图标、pdf文档这些，结果迅睿CMS默认禁止这些后缀上传，相当于保安把你的货当成违禁品扣了，直接给你退回来，报迅睿CMS文件上传失败。

这个更好解决，打开系统设置->上传配置->允许上传后缀，把你要传的后缀加进去，记得用英文逗号隔开就行，加完保存再传，立马就好，规矩是死的人是活的，改一下规则就顺畅了。

过来人最后给你整理避坑清单

• 遇到迅睿CMS文件上传失败先查文件大小，优先排查这个，省80%的时间
• 大小没问题就查目录权限，Linux服务器一定要给读写权限，点两下就完事
• 迁站换域名之后一定要先测试上传，别等上线了出问题再慌
• 传特殊后缀先加白名单，别上来就传，肯定给你打回来

说真的，我前前后后遇到不下十次迅睿CMS文件上传失败，一开始我也慌，以为服务器坏了、CMS有毒，找了好多教程都讲得云里雾里，要么太专业听不懂，要么说不到点上，自己踩完坑才发现，百分之九十的迅睿CMS文件上传失败都是以上几个小问题，根本不是啥大毛病。

咱做网站搞开发，不就是遇到问题解决问题嘛，今天踩一个坑，明天就少踩一个，遇到迅睿CMS文件上传失败别慌，按着我给你说的顺一遍，基本都能搞定，我踩过的坑都给你摆这了，你直接拿过去用就行，比你瞎搜一下午省时间多了，真要是还搞不定，评论区留个言，咱过来人再给你唠明白！