PG官网

400-920-5594
173-6014-8050
首页 > 资讯中心 > 技术分享
附件图片存在服务器本地,换机器或重装后为什么找不回来
2026-11-17 4 技术分享

  后台上传的合同照片或商品图片,数据库记录还在,客户打开附件却变成裂图。这类问题有时被归成前端缓存,实际可能是文件只存在某台服务器本地目录,换机器、重装系统、重新部署或备份数据库后,文件没有跟着业务记录一起迁移。附件存储看起来只是存几张图片,风险常出在文件放哪里、路径怎么记、备份带不带、多台机器怎么共享这些环节。

一、附件图片为什么会丢,常出现在哪些环节

PG官网

  浏览器和小程序先把文件传到后端,后端再决定写到哪个目录。服务实例各自往本机磁盘写时,任务落到另一台机器或文件同步失败,数据库能查到记录,对应目录却没有文件。多台应用服务器、定时任务生成附件、临时目录被系统清理时,这类问题更容易出现。

  单机本地目录存放业务附件,文件和代码包混在同一个发布目录,新部署覆盖旧目录时上传图片可能被一起清掉。有些项目把附件放在项目根目录、临时文件夹或固定桌面路径,开发环境和正式环境目录层级不同,迁移后按原路径自然找不到文件。

  数据库只保存图片名称或相对路径,文件实体留在服务器磁盘。备份、迁移或重装时如果只导出数据表、代码包和配置,附件目录没有纳入备份,恢复后业务记录还在,图片实体已经丢失。图片目录体积较大,定期打包时容易被排除在外。

  访问附件还要经过静态目录映射或下载接口。服务器重装后,IIS、Nginx、站点配置或虚拟目录没有恢复,页面路径还在,访问却被拦在权限或配置层。权限不对会提示无权限,目录映射丢失会返回 404,这两类问题和文件真正丢失在页面上看起来很接近。

二、本地存储容易留下哪些断点

PG官网

  上传时只把文件路径写进业务表,没有记录文件元信息。原文件名、大小、类型、上传时间、上传人、业务编号、存储目录和文件标识缺失,后续想按合同、商品或订单找回附件,只能凭文件名和路径猜。多人上传同名文件时,后一张还可能覆盖前一张。

  文件目录和代码发布目录没有分开。项目目录每次打包部署都会被替换,上传图片混在里面,发布脚本清理旧文件或复制新包时附件容易被覆盖删除。开发、测试、生产使用同一套目录约定,换机后盘符、站点根目录或上级层级不一致,原来的相对链接就会断。

  备份范围只覆盖数据库和代码,附件目录游离在备份清单外。定时打包服务端文件时漏掉上传目录,云主机快照只备份系统盘,数据盘未挂载或未纳入快照,换机器后只恢复了应用和表数据。备份恢复演练不检查附件目录,等到图片打不开才发现备份包里没有文件。

  多实例环境没有共享存储。每台应用服务器写各自本地磁盘,用户第一次在机器 A 上传,后续查看走机器 B,图片自然不在本机。定时任务、消息队列或后台接口生成的附件落在不同实例,目录之间没有同步机制,多人访问同一批资料时会出现部分人能看、部分人裂图。

  迁移和重装前缺少文件核对。先在旧服务器导出数据库,再把代码部署到新机器,附件目录没有按同样结构迁移,或迁移后继续使用旧绝对路径,没有调整静态地址、站点配置和下载接口。文件名包含中文、空格、特殊字符,跨系统复制时编码变化,路径也可能对不上。

三、附件长期存放要怎么做

PG官网

  先把上传目录和代码目录分开。业务附件放在独立挂载的数据目录或数据盘,不跟发布包一起打包、覆盖和清理。配置项只记录基础目录和文件标识,不把盘符、站点根目录等环境路径写死到业务表。应用重启、代码回退或重新部署时,附件目录保持不动。

  文件元数据单独建表管理。每条附件记录关联业务编号、原文件名、文件标识、存储路径或对象 key、大小、类型、上传人、上传时间和存储位置。数据库负责业务关联,文件负责实体存放,查询附件时先取元数据,再按统一规则拼接访问地址。原图、缩略图、裁剪版本分别记录 key,避免互相覆盖。

  文件命名按日期、业务类型和随机标识生成,不直接用用户上传的原始名称作为磁盘文件名。目录层级可以按日期或业务编号拆分,避免单个目录堆积过多文件。特殊字符统一转义,扩展名和类型一并记录,下载时按元数据还原原文件名。

  备份清单要覆盖数据库和附件目录。定期校验目录内文件能否打开、大小是否正常,数据库记录的文件标识能否在对应目录找到。数据库快照和文件备份尽量保持同一时间点,迁移后先核对附件数量、抽查关键业务图片,再切换正式访问入口。

  多实例和集群环境使用共享文件服务或对象存储。本地磁盘只作为临时上传缓存,文件落库后同步到共享存储,应用实例统一从共享位置读取。接入对象存储时保留文件元数据表,业务系统不直接绑定某台服务器路径。迁移、扩容或下线单台机器时,附件不随实例一起消失。

  出问题按记录、文件、映射、权限逐层核对。先查数据库里的附件记录和文件标识,再到对应服务器或存储目录核对实体文件,接着检查静态映射、站点配置和访问权限。迁移后出现裂图,要区分路径变更、目录未迁移、备份缺失、实例未共享和权限拦截几类原因,并把缺失记录补进发布和迁移检查单。

  附件存储不能只把上传文件扔到一个文件夹就算完成。业务记录要和文件实体对应,上传目录要独立保留,备份和迁移要把文件一起带上,多实例要有共享位置。长期归档附件和变化快的业务资料都要提前约定保留方式,避免客户要查合同附件时才发现服务器上已经找不到原图。

推荐文章查看更多》

网站地图