Gatsby无法生成已创建的shirts页面报404 其余页面运行正常

第一优先级：文件基础校验 #

• 确认src/pages目录下的shirts页面文件名拼写、大小写完全正确：Gatsby路由对大小写敏感，需保证文件名为shirts.js/shirts.tsx，无拼写错误、多余空格/特殊字符、无大写开头
• 确认文件内组件为默认导出，错误的命名导出会导致Gatsby无法识别为页面文件，参考正确写法：

// 正确写法
export default function ShirtsPage() {
  return <div>Shirts页面内容</div>
}

// 错误写法（会导致页面不生成）
export function ShirtsPage() {
  return <div>Shirts页面内容</div>
}

第二优先级：Gatsby专属缓存清理 #

已做的依赖重装操作无效时，执行Gatsby专属缓存清理流程：

• 停止所有Gatsby运行进程，删除项目根目录下的.cache和public两个缓存文件夹，可直接在项目根目录执行命令：
  rm -rf .cache public
• 清理完成后重新执行gatsby develop启动服务，不要复用之前的缓存启动项

第三优先级：配置规则排查 #

• 检查gatsby-node.js文件内的createPages等路由生成逻辑，是否存在针对/shirts路径的过滤、拦截规则，导致页面生成被跳过
• 检查gatsby-config.js内的gatsby-plugin-page-creator等插件配置，是否配置了页面排除规则，将shirts页面过滤

第四优先级：路径冲突排查 #

• 检查static目录下是否存在名为shirts的文件或文件夹，静态资源会优先于pages路由匹配，产生路径冲突
• 检查是否存在[category].js这类动态路由文件，动态路由优先级配置过高时会覆盖/shirts固定路由

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