Typecho附件图片上传失败？目录不可写权限不足零基础修复方法
Typecho博客日常运营中，站长上传文章配图、缩略图、附件文档时，频繁出现上传失败、提示目录无法写入、权限不足、文件拦截等报错，无法正常更新博客图文内容，严重影响文章编辑和站点优化。Typecho上传故障90%源于目录权限异常、服务器配置限制、文件规则拦截，极少是程序源码问题。本文从权限、配置、规则三个维度，详解全套零基础修复方案，彻底根治上传报错。
修复核心目录权限，解决目录不可写核心报错。Typecho所有上传附件默认存储在usr/uploads目录，该目录权限不足是上传失败的首要诱因。服务器默认目录多为只读权限，程序无法写入、保存上传文件，直接触发上传报错。通过FTP工具、宝塔面板、服务器终端，将网站根目录下usr/uploads目录权限设置为755，目录内文件权限设置为644；独立服务器需修改目录归属用户为www、nginx运行用户，解除权限锁定，赋予程序完整读写权限。
调整Nginx与PHP参数，解除文件大小限制。默认服务器配置会限制上传文件尺寸和请求超时时间，高清大图、压缩包、PDF文档容易超出限制导致上传中断、失败。编辑php\.ini配置文件，调大upload\_max\_filesize、post\_max\_size参数，延长脚本执行超时时间；同时修改Nginx配置文件，新增client\_max\_body\_size参数，调大服务器允许的最大上传文件体积，适配各类素材上传需求。参数修改完成后，重启PHP、重载Nginx服务生效。
清理拦截规则与缓存，杜绝隐性上传故障。部分服务器安全防护、防注入插件会拦截图片、附件上传，需将usr/uploads目录加入安全白名单；关闭站点自定义文件拦截规则，允许jpg、png、webp、gif、pdf、zip等常用格式上传。同时清空浏览器缓存、站点缓存，避免缓存错乱导致上传误拦截。若存在中文文件名乱码导致的上传失败，可开启Typecho后台文件自动重命名功能，规避编码异常问题。
完成全套优化配置后，多设备多次测试图片、附件上传功能，确认无报错、文件正常保存展示。日常运维中无需频繁修改配置，定期维护目录权限，即可长期保障Typecho附件上传功能稳定运行。
更新时间：2026-08-15 02:34:41
上一篇：讯睿CMS全站缓存开启后内容不更新？页面刷新无效缓存叠加修复方法