本文详细指导如何在vite项目中配置构建输出的公共基础路径，以解决将应用部署到web服务器子目录时出现的资源404错误。通过使用`--base`命令行参数或在`vite.config.js`中设置`base`选项，确保生成的所有资源链接正确指向部署路径，从而实现无缝的应用部署。
在开发基于Vite的应用时，我们通常会在本地开发服务器（如http://localhost:3000）上进行测试。然而，当应用完成开发并准备部署时，一个常见场景是将Vite构建输出（即dist目录的内容）放置到Web服务器的某个子目录中。例如，一个Vite应用可能被部署到http://myapp.com/docs/reconstatus/路径下。在这种情况下，如果Vite构建输出中的静态资源（如JavaScript、CSS、图片等）的链接默认以/开头，它们会被解析为相对于域名根目录的绝对路径（例如/js/app.js会被解析为http://myapp.com/js/app.js），而不是相对于子目录的路径。这会导致浏览器尝试从错误的路径加载资源，最终引发404错误。
理解问题根源
Vite在默认构建时，会生成相对于项目根目录的资源链接。例如，如果你的应用部署在http://myapp.com/docs/reconstatus/，并且Vite生成了一个指向/assets/index.js的脚本标签，浏览器会尝试访问http://myapp.com/assets/index.js。但实际上，这个文件可能位于http://myapp.com/docs/reconstatus/assets/index.js。这种路径不匹配是导致404错误的核心原因。
解决方案：配置公共基础路径
Vite提供了一个简单而强大的机制来解决这个问题，即配置“公共基础路径”（Public Base Path）。这个路径会作为所有生成资源URL的前缀。
方法一：通过命令行参数进行配置
最直接的方法是在执行vite build命令时，通过--base参数指定公共基础路径。
vite build --base=/docs/reconstatus/
在这个例子中，/docs/reconstatus/就是你的应用在Web服务器上的实际部署子目录。执行此命令后，Vite会确保所有生成的资源链接都以/docs/reconstatus/作为前缀。例如，如果之前生成的是/assets/index.js，现在就会变成/docs/reconstatus/assets/index.js，从而正确地指向文件位置。
注意事项：
- 确保路径以斜杠开头和结尾（例如/docs/reconstatus/），这表示它是一个相对于域名根目录的绝对路径，但Vite会将其作为所有内部资源的前缀。
- 此方法适用于快速测试不同部署路径，或在CI/CD流程中动态设置部署路径。
方法二：通过vite.config.js进行配置
对于更持久或更复杂的配置，推荐在项目的vite.config.js（或vite.config.ts）文件中设置base选项。这使得配置成为项目的一部分，易于管理和版本控制。
// vite.config.js
import { defineConfig } from 'vite';
import vue from '@vitejs/plugin-vue';
export default defineConfig({
// 根据实际部署路径修改此处的base值
base: '/docs/reconstatus/', // 例如，如果部署在 http://myapp.com/docs/reconstatus/
plugins: [vue()],
build: {
// 可以在这里添加其他构建选项
outDir: 'dist', // 默认输出目录
},
});设置完成后，只需运行vite build，Vite就会自动使用vite.config.js中定义的base路径进行构建。
注意事项：
- base选项的值可以是绝对路径（如/docs/reconstatus/），也可以是相对路径（如./）。
- 当部署在子目录时，通常使用绝对路径。
- 当应用部署在域名根目录，或者所有资源都与index.html在同一级别时，可以使用./或不设置base（Vite默认会处理这种情况）。
- 在某些场景下，你可能需要根据不同的环境（开发、测试、生产）设置不同的base路径。你可以利用环境变量来实现：
// vite.config.js
import { defineConfig, loadEnv } from 'vite';
import vue from '@vitejs/plugin-vue';
export default defineConfig(({ command, mode }) => {
// 加载对应环境的.env文件
const env = loadEnv(mode, process.cwd(), '');
return {
base: env.VITE_APP_BASE_PATH || '/', // 默认使用根路径，或从环境变量获取
plugins: [vue()],
build: {
outDir: 'dist',
},
};
});然后，你可以在.env.production文件中定义：
VITE_APP_BASE_PATH=/docs/reconstatus/
在构建时，Vite会加载.env.production文件，并将base设置为/docs/reconstatus/。
总结
正确配置Vite构建的公共基础路径是解决子目录部署时资源404问题的关键。通过在vite build命令中使用--base参数，或者在vite.config.js中设置base选项，你可以确保Vite生成的所有资源链接都与你的应用部署路径相匹配。选择哪种方法取决于你的项目需求和部署流程的复杂性。对于大多数情况，在vite.config.js中明确设置base是一个更清晰、更易于维护的解决方案。理解并应用这一配置，将使你的Vite应用部署过程更加顺畅。
