Xunruicms上传图片失败：目录权限与PHP配置_Xunruicms_上传设置_PHP配置
帮客户维护Xunruicms站点，上传图片失败占了工单很大比例。同样的问题在不同主机上解法略有差异，底层逻辑一致。把处理过的案例汇总成标准流程，覆盖虚拟主机、VPS、宝塔面板三种环境。
接手一个Xunruicms站点，这个功能之前是好的，突然不能用了。这种情况先回忆最近做过什么操作：升级了CMS？改了模板？换了服务器？装了新插件？变更点往往就是问题根源，回退变更验证一下。
下面把操作过程详细写出来，每一步都有明确动作。
先看报错信息。提示目录不可写，改upload目录权限为755，属主设为www。提示文件太大，改php.ini的upload_max_filesize和post_max_size。提示文件类型不允许，后台允许的文件类型里加扩展名。
图片上传后不显示，检查上传路径配置和URL路径。Xunruicms后台附件路径设置要和实际目录一致，URL前缀要带域名或者用相对路径。
大文件上传还要改max_execution_time，给上传留足够时间。超过10M的文件建议用FTP上传到附件目录，再在后台添加，不走PHP上传更稳定。
做的过程中注意以下事项。
HTTPS和HTTP混合内容会导致浏览器安全警告。切换HTTPS后检查页面所有资源链接，图片、CSS、JS都要用HTTPS。数据库批量替换http://为https://。
CMS和插件及时更新到最新稳定版，更新前先看更新日志和兼容性说明，备份后再升级。大版本升级在测试环境验证，不要直接在生产环境升。
不要在网站根目录放phpinfo.php等敏感文件，测试完立即删除。这些文件暴露服务器配置信息，被攻击者利用。测试用的临时文件用完就删，保持目录干净。
Xunruicms版本不同，配置项位置和文件路径可能有差异。网上教程要注意看对应版本，版本差太多可能不适用。官方文档最权威，以官方文档为准，第三方教程做补充。
还有几个相关问题顺便提一下。
问：多站点怎么配置？答：Xunruicms部分版本支持多站点，在后台站点管理里添加，每个站点绑定独立域名，用不同模板或者同一模板。服务器上域名都解析到同一目录，由CMS根据域名判断。
问：数据库导入失败提示字符集错误？答：导出和导入数据库字符集要一致，统一用utf8mb4。导入时在phpMyAdmin选择正确字符集。SQL文件太大用命令行导入，比phpMyAdmin稳定。
技术问题最怕一知半解就动手改配置。Xunruicms的这个功能涉及几个配置项联动，改一个不改另一个就会出问题。这篇文章把关联配置都列出来了，按顺序操作不会漏项。
更新时间：2026-08-27 00:40:34