Astro项目构建报错：路径出现重复盘符C:\\C:\\如何解决？

错误原因分析 #

1. 路径重复错误：报错中的C:\\C:\\Users\\...是路径拼接重复，大概率是astro-favicons插件在Windows环境下的路径处理bug，导致尝试创建不存在的嵌套路径。
2. 输出模式不匹配：当前配置output: "server"配合Vercel serverless适配器，会生成适配Vercel的服务器端代码，不会生成用于FTP上传的静态dist文件夹。

解决方案 #

1. 修复路径重复问题 #

• 临时排查：先注释掉astro-favicons集成，运行npm run build测试是否能正常构建：

  // 注释掉这一行
  // favicons({ ... }),
  

  如果构建成功，说明问题来自该插件。
• 插件修复：
  • 升级astro-favicons到最新版本：运行npm update astro-favicons
  • 手动指定输出目录，在favicons配置中添加outputDir: './public'：

    favicons({
      appName: "Dungeon Radio Club",
      appShortName: "DRC",
      appDescription: "dungeonradioclub c:",
      lang: "pt-BR",
      masterPicture: "./src/assets/dungeon_logo_small.svg",
      emitAssets: true,
      faviconsDarkMode: false,
      path: "/",
      outputDir: "./public" // 新增这一行
    }),
    

2. 调整配置生成静态dist文件夹 #

要生成适合FTP上传的静态文件，需修改输出模式并移除Vercel适配器：

import { defineConfig } from "astro/config";
import tailwind from "@astrojs/tailwind";
import solidJs from "@astrojs/solid-js";
import compress from "astro-compress";
import critters from "astro-critters";
import sitemap from "@astrojs/sitemap";
import favicons from "astro-favicons";

export default defineConfig({
  output: "static", // 改为static模式
  site: "https://dungeonradioclub.com/",
  integrations: [
    tailwind(),
    solidJs(),
    compress(),
    critters(),
    sitemap(),
    favicons({
      appName: "Dungeon Radio Club",
      appShortName: "DRC",
      appDescription: "dungeonradioclub c:",
      lang: "pt-BR",
      masterPicture: "./src/assets/dungeon_logo_small.svg",
      emitAssets: true,
      faviconsDarkMode: false,
      path: "/",
      outputDir: "./public" // 加上这一行修复路径
    }),
  ],
  // 移除或注释掉Vercel适配器
  // adapter: vercel(),
});

3. 验证构建 #

修改配置后，运行npm run build，成功后项目根目录会生成dist文件夹，里面的所有文件即可通过FTP上传到静态主机。

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