Craft CMS 5.x 在无头模式下修改条目索引页面的前端链接

在Craft CMS 5.6.10.2版本中，当使用无头(Headless)模式搭建网站时，条目索引页面上的世界图标链接默认会指向CMS的基础URL，而不是前端应用的基础URL。本文将详细介绍这个问题的原因和解决方案。

问题背景

在Craft CMS的无头架构中，通常会有两个独立的系统：

1. CMS后端 - 用于内容管理
2. 前端应用 - 通过GraphQL或其他API获取内容并呈现给用户

在条目索引页面中，每个条目旁边会显示一个世界图标，点击后会尝试打开该条目的前端页面。但在无头模式下，这个链接默认会指向CMS的基础URL，导致出现404错误。

问题原因

这个问题的根源在于系统默认使用站点设置中的"Base URL"来生成这些前端链接。在传统CMS架构中，这通常不是问题，因为CMS和前端是同一个系统。但在无头架构中，CMS和前端是分离的，因此需要特别配置。

解决方案

要解决这个问题，需要在Craft CMS的站点设置中将"Base URL"修改为前端应用的基础URL。具体步骤如下：

1. 登录Craft CMS后台
2. 进入设置 → 站点
3. 找到对应的站点设置
4. 将"Base URL"修改为前端应用的基础URL
5. 保存设置

修改后，条目索引页面上的世界图标链接将会正确地指向前端应用，而不是CMS本身。

注意事项

1. 确保前端应用已经正确配置了路由，能够处理来自Craft CMS的URL格式
2. 如果使用多站点功能，需要为每个站点单独配置其对应的前端URL
3. 在修改Base URL后，可能需要清除缓存才能看到效果

技术原理

Craft CMS生成这些前端链接的核心逻辑是基于getUrl()方法，该方法会使用站点配置中的Base URL作为基础。在无头模式下，这个Base URL应该指向实际呈现内容的前端应用，而不是内容管理的后端系统。

通过正确配置Base URL，不仅可以解决条目索引页面的链接问题，还能确保整个CMS系统中生成的所有前端URL都指向正确的位置。