Statamic 5.58.1：嵌套条目关联的集合路由出现404错误

问题场景 #

• Galleries集合计划使用路由my.site/photogallery/{season}/{gallery}
• 每个Gallery条目通过season字段（entries类型，关联Seasons集合，单选模式）关联已发布的Season条目（slug为season-123）
• Galleries集合的路由配置（galleries.yaml）：route: /fotogalerij/{season:slug}/{slug}
• 两个条目均已发布，ID、slug、关联关系均验证正确
• 无自定义Laravel路由干扰，已执行php artisan statamic:stache:clear和php artisan cache:clear清除缓存
• 访问/photogallery/season-123/gallery-456出现404，但用自定义控制器可加载数据（丢失Statamic布局/Antlers特性）

相关文件信息 #

• content/collections/galleries/gallery-456.md：season: <season-123-id>
• content/collections/seasons/season-123.md：id: <season-123-id>
• resources/blueprints/collections/galleries/gallery.yaml：season字段为entries类型，关联Seasons集合，单选模式

已尝试操作 #

• 反复核对slug、ID及关联关系
• 在控制面板重新保存条目
• 清除所有缓存
• 确认无自定义路由冲突

排查与解决步骤 #

1. 修正路由路径拼写不一致问题 #

你配置的路由前缀是/fotogalerij/，但访问的URL用的是/photogallery/——这是最直接的404原因。把galleries.yaml里的路由配置改成：

route: /photogallery/{season:slug}/{slug}

或者统一访问路径为/fotogalerij/season-123/gallery-456。

2. 验证关联字段句柄的精确性 #

确保Gallery蓝图中season字段的句柄是小写的season（无大小写错误或拼写偏差），Statamic路由解析完全依赖字段句柄的精确匹配。可以在控制面板的Gallery蓝图编辑页确认字段句柄，无误后重新保存Gallery条目。

3. 检查Season条目的可访问性 #

确认Season条目满足：

• 无发布/过期日期限制（如果设置了，确保当前时间在有效期内）
• 无权限限制（比如未设置仅特定用户组可见）
• Seasons集合的路由配置未被禁用（即使Season本身不需要前端路由，也要保证集合路由功能处于启用状态）

4. 强制刷新Statamic路由缓存 #

除了已执行的缓存清除命令，额外执行：

php artisan statamic:routes:clear

这条命令会专门清除Statamic的路由缓存，确保新的路由配置生效。

5. 确认关联字段的存储格式 #

如果是手动编辑Markdown文件添加的关联ID，确保格式正确：单选entries字段的存储值应为单个ID字符串，而非数组。正确格式示例：

season: abc123-def456-ghi789

如果写成数组（season: ["abc123-def456-ghi789"]），会导致路由解析时无法正确读取关联条目。

6. 检查集合路由启用状态 #

确认Galleries和Seasons集合的配置中，route选项未被注释或设置为false，Statamic需要集合路由功能启用才能解析嵌套关联路由。

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