如何获取Shopware 6中文档的持久化链接？

当在Shopware管理界面更新文档详情并执行“更新并替换”操作时，文档会生成新ID，导致所有指向该文档的外部链接失效。目前所有SHOPWARE_CDN_STRATEGY_DEFAULT相关配置都无法解决这个问题，因为所有链接都会在文件名前添加ID或其他唯一值：

• 原文档链接：example.com/12345/filename.pdf
• 更新后文档链接：example.com/67890/filename.pdf

可行解决方案 #

1. 自定义CDN策略 #

创建自定义CDN策略类，继承Shopware的AbstractCdnUrlStrategy，重写generate方法，去掉默认的ID前缀逻辑，直接使用文件名作为访问路径的核心部分，让链接仅保留文件名相关内容。

2. 配置媒体别名 #

在Shopware媒体管理中，为目标文档设置固定的媒体别名。设置完成后，可通过/media/alias/[你的自定义别名]的形式访问文档，即使后续执行“更新并替换”操作，只要别名不变，访问链接就会保持有效。

3. 阻止更新时生成新ID #

通过事件订阅器监听MediaEvents::MEDIA_UPLOAD事件，在文档更新替换时强制复用原媒体ID，避免生成新ID导致路径变更。注意：这种方式会跳过默认的媒体版本生成逻辑，需根据业务对版本管理的需求评估是否适用。

4. 添加自定义路由规则 #

在Shopware的路由配置中新增自定义路由，将固定的URL路径（比如/documents/filename.pdf）映射到目标文档媒体对象。后续更新文档时只要保持文件名不变，该自定义路由就能持续指向最新的文档版本。

内容的提问来源于stack exchange，提问作者loken