Astro项目本地启动失败：找不到astro/config模块求助

问题详情 #

使用Astro Stone启动模板开发的项目，前一日提交Git后在Netlify上可正常运行，但次日本地启动时遭遇报错，提示无法找到astro/config与astro-compress模块，无法加载Astro配置，导致项目无法编译启动。此前其他项目也曾出现类似问题。

终端报错信息 #

aiden@192-168-1-102 site % npm run dev

> astro-theme-stone@1.0.0 dev
> astro dev

10:42:14 AM [vite] Error when evaluating SSR module /Users/aiden/Documents/GitHub/LTEK : iSupport/LTEK-v8.5/site/astro.config.mjs: failed to import "astro/config"
|- Error: Cannot find module 'astro/config' imported from '/Users/aiden/Documents/GitHub/LTEK : iSupport/LTEK-v8.5/site/astro.config.mjs'
    at nodeImport (file:///usr/local/lib/node_modules/astro/node_modules/vite/dist/node/chunks/dep-2b82a1ce.js:56075:25)
    at ssrImport (file:///usr/local/lib/node_modules/astro/node_modules/vite/dist/node/chunks/dep-2b82a1ce.js:55977:30)
    at eval (eval at instantiateModule (file:///usr/local/lib/node_modules/astro/node_modules/vite/dist/node/chunks/dep-2b82a1ce.js:56036:28), <anonymous>:3:50)
    at instantiateModule (file:///usr/local/lib/node_modules/astro/node_modules/vite/dist/node/chunks/dep-2b82a1ce.js:56039:15)

Failed to load url astro/config (resolved id: astro/config) in /Users/aiden/Documents/GitHub/LTEK : iSupport/LTEK-v8.5/site/astro.config.mjs. Does the file exist?
Failed to load url astro-compress (resolved id: astro-compress) in /Users/aiden/Documents/GitHub/LTEK : iSupport/LTEK-v8.5/site/astro.config.mjs. Does the file exist?
[astro] Unable to load your Astro config

 error   Cannot find module 'astro/config' imported from '/Users/aiden/Documents/GitHub/LTEK : iSupport/LTEK-v8.5/site/astro.config.mjs'
  File:
    /usr/local/lib/node_modules/astro/node_modules/vite/dist/node/chunks/dep-2b82a1ce.js:56075:25
  Code:
    56074 |         if (!resolved) {
    > 56075 |             const err = new Error(`Cannot find module '${id}' imported from '${importer}'`);
            |                         ^
      56076 |             err.code = 'ERR_MODULE_NOT_FOUND';
      56077 |             throw err;
      56078 |         }
  Stacktrace:
Error: Cannot find module 'astro/config' imported from '/Users/aiden/Documents/GitHub/LTEK : iSupport/LTEK-v8.5/site/astro.config.mjs'
    at nodeImport (file:///usr/local/lib/node_modules/astro/node_modules/vite/dist/node/chunks/dep-2b82a1ce.js:56075:25)
    at ssrImport (file:///usr/local/lib/node_modules/astro/node_modules/vite/dist/node/chunks/dep-2b82a1ce.js:55977:30)
    at eval (eval at instantiateModule (file:///usr/local/lib/node_modules/astro/node_modules/vite/dist/node/chunks/dep-2b82a1ce.js:56036:28), <anonymous>:3:50)
    at instantiateModule (file:///usr/local/lib/node_modules/astro/node_modules/vite/dist/node/chunks/dep-2b82a1ce.js:56039:15)

Astro配置文件 #

import { defineConfig } from 'astro/config';
import tailwind from '@astrojs/tailwind';
import compress from 'astro-compress';

// https://astro.build/config
export default defineConfig({
  experimental: {
    viewTransitions: true,
  },
  integrations: [tailwind(), compress()],
});

解决方案 #

1. 清理并重新安装本地依赖 #

本地依赖可能出现损坏或缺失，执行以下步骤：

• 删除node_modules文件夹：
  Mac/Linux：rm -rf node_modules
  Windows：rmdir /s /q node_modules
• 删除锁文件：rm package-lock.json（如果用yarn则删除yarn.lock）
• 重新安装依赖：npm install

2. 解决全局与本地Astro版本冲突 #

报错显示使用了全局安装的Astro，若全局版本与项目本地版本不一致，会导致模块解析错误：

• 查看全局Astro版本：npm list -g astro
• 优先使用本地命令启动项目：npx astro dev
• 或卸载全局Astro：npm uninstall -g astro，之后用npm run dev启动

3. 确认astro-compress依赖已安装 #

检查项目根目录的package.json，若没有astro-compress依赖，手动安装：

npm install astro-compress --save-dev

4. 修复项目路径的特殊字符 #

从报错路径可以看到，项目文件夹名称包含空格和冒号（LTEK : iSupport），这会干扰Node的模块解析机制。建议重命名文件夹，去掉空格、冒号等特殊字符，比如改为LTEK-iSupport，之后重新启动项目。

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