改版项目里有一类问题特别烦人：新站上线看着一切正常，过几天客户反馈某个产品图打不开、某个资料 PDF 下载不了。图和附件都在老站上，改版的时候没搬过来，或者搬了但地址对不上。图片和附件是网站改版里最容易被轻视的一块。页面结构、栏目内容有人盯，散落在各年新闻、产品详情里的几百张图和几十份附件却常常没人盘点。下面按"迁移前、迁移中、上线后"三段，把这件事理一遍。
改版项目里有一类问题特别烦人：新站上线看着一切正常，过几天客户反馈某个产品图打不开、某个资料 PDF 下载不了。图和附件都在老站上，改版的时候没搬过来，或者搬了但地址对不上。
图片和附件是网站改版里最容易被轻视的一块。页面结构、栏目内容有人盯，散落在各年新闻、产品详情里的几百张图和几十份附件却常常没人盘点。下面按"迁移前、迁移中、上线后"三段，把这件事理一遍。
一、迁移前：先给老站做一次资产盘点
动手改版前，先回答三个问题：
1. 图片存在哪。是存在网站自己的 uploads 目录，还是存在图床、OSS 之类的外部对象存储？两种情况的迁移方式完全不同。
2. 附件有多少、都是什么。把老站后台的附件目录列一份清单：PDF 规格、产品手册、证书扫描件、表格，逐类记录数量和体积。
3. 哪些内容引用了它们。新闻正文、产品详情、下载中心、页脚资料，凡是插过图或挂过附件的地方都要在清单里，迁移时按这份清单核对，而不是凭印象。
这一步建议在老站还能正常访问时做。老站一关，很多地址就再也对不上了。
二、图片迁移的三种做法和适用场景
1. 整目录搬运。把老站 uploads 目录整包下载、再整包上传到新站，保持目录结构不变。老站地址是 /uploads/2021/xx.jpg 的，新站同名路径下文件还在。这种方式工作量最小，适合新旧站都用同一套 CMS 或目录结构相近的情况。
2. 逐篇重新上传。内容量不大（几百条以内）或者借改版做内容梳理的，可以逐篇把图重新上传、重新插入。缺点是耗时，优点是顺手把老图压缩、改名、删除失效图，一步到位。
3. 数据库批量替换地址。内容量大、图片来源统一时，迁移后在数据库里把老图片域名批量替换成新地址。这一步必须先备份数据库再执行，替换前先在测试环境验证。
不管用哪种，都要在迁移后抽查正文里的图片能否打开，别只看列表页——列表页缩略图正常，不代表每篇正文里的图都正常。
还有一点要留意：图片格式。有些老站图片还是 BMP、TIFF 之类的老格式，体积大、浏览器兼容性也差，迁移时顺手转成 JPG 或 WebP，既减体积又省去后续的兼容问题。另外，如果老站图片带原始大图加缩略图两层结构，确认新站也保留了"点开看大图"的能力，别只迁了缩略图。
三、附件迁移：最容易丢的一环
附件比图片更容易出问题，因为附件往往不在正文里，而在"下载中心""资料下载"这类独立板块，改版时新站栏目一变，这块就断了。做法上注意三点：
1. 附件整包搬运。和图片一样，把附件目录整包迁移，保持相对路径结构，新旧地址能对上的尽量对上。
2. 做一份新旧地址对照表。新站目录结构和老站不同的，把老附件地址逐条映射到新地址，上线后按表核验。
3. 找不到出处的附件先归档。盘点中发现的来历不明的旧文件，不要直接删，集中放到一个归档目录里确认后再处理，避免误删还在被引用的资料。
四、上线后排查：丢图、丢附件的常见原因
新站上线后发现图丢了，按这个顺序查，多数能定位：
1. 地址没跟上。正文里写的是老域名或绝对路径，新站环境下解析不到。表现是图片位置出现裂图标志。处理：数据库或正文批量替换成相对路径。
2. 文件确实没迁过来。地址对、但服务器上没有这个文件。对照迁移前的资产清单补传。
3. 大小写或扩展名问题。Windows 环境下不区分大小写，迁到 Linux 服务器后 XX.JPG 和 xx.jpg 就是两个文件。整包迁移后逐类抽查能提前发现。
4. 附件被服务器拦截。部分主机对 PDF、压缩包上传有限制，或者安全策略拦截了下载请求，表现为浏览器直接下载失败或返回错误页。查服务器日志能确认。
5. 缩略图正常、原图丢失。有些 CMS 列表页用的是自动生成的缩略图，缩略图还在不代表原图迁过来了，必须点进正文验证。
排查时建议从浏览器开发者工具入手：在图片位置点右键选"检查"，看这张图实际请求的地址是什么，再用这个地址单独打开一次。返回 404 说明文件没迁到，返回跳转说明地址替换不彻底，返回 403 多半是权限或拦截问题。先看请求结果再动手，比凭感觉猜快得多。
五、把这件事变成改版验收的固定项
建议把图片和附件纳入改版验收清单：抽查正文图片若干篇、逐条核对附件对照表、测试下载链接若干个，全部通过才算交付。花半天时间做验收，比上线后被客户一个个找回来处理省事得多。
锐客网承接企业网站改版与老站数据迁移，迁移前后都有资产盘点和验收流程，确保图片、附件一件不少地迁到新站。有改版计划的欢迎来电沟通：137-9839-1694。
