重构后SvelteKit频繁出现“Error: Not found”错误求助

以下是针对该问题的具体解决步骤：

• 彻底清理构建缓存与依赖
  仅删除.svelte-kit可能无法清除所有旧路径残留，执行以下命令彻底重置构建环境：

  rm -rf .svelte-kit node_modules
  npm install
  npm run build
  

  重新安装依赖并构建后，能彻底清除旧路径的关联缓存。

• 检查SvelteKit配置文件
  打开svelte.config.js，确认预处理器配置中是否存在硬编码的旧SCSS路径。比如scss的includePaths若之前设置为src/lib/scss，需更新为迁移后的路径：

  import adapter from '@sveltejs/adapter-auto';
  import preprocess from 'svelte-preprocess';
  
  const config = {
    preprocess: preprocess({
      scss: {
        sassOptions: {
          includePaths: ['src/lib'], // 修改为新的根路径
        },
      },
    }),
    kit: {
      adapter: adapter(),
    },
  };
  
  export default config;
  

• 排查全局样式的隐性引用
  检查app.html文件，确认是否存在通过<link>标签直接引用旧路径SCSS的情况，若有则将路径更新为$lib/app.scss或对应新路径。

• 重启开发服务器与编辑器
  开发模式下的热重载可能残留旧模块引用，彻底关闭npm run dev进程后重新启动。同时重启代码编辑器（比如VS Code可通过Ctrl+Shift+P选择"Developer: Reload Window"），清除编辑器的文件索引缓存。

问题原因分析 #

这种偶发错误源于SvelteKit的模块解析缓存、预处理器缓存，或是编辑器的文件索引中仍保留旧路径的引用。即便代码中的导入语句已全部更新，未清理的缓存仍会偶尔触发找不到旧文件的提示。简化routes后，SvelteKit会重新扫描整个项目依赖树，旧缓存中的引用被更多触发，因此问题表现得更严重。

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