Strapi v5开发环境运行两个项目遇端口冲突问题求助

你的配置问题点 #

1. 配置文件路径错误：Strapi v5只会读取src/admin/vite.config.js（或.ts）中的Vite配置，如果你把代码放在了项目根目录的vite.config.js，Strapi不会加载这个配置，自然不会生效。
2. 配置属性错误：你在server节点下添加了clientPort，但Vite的server配置中没有这个顶层属性；同时HMR配置里重复的clientPort也是多余的，可能导致配置解析异常。

正确解决方法 #

方法1：用环境变量快速指定端口（最简便） #

不需要修改任何配置文件，启动第二个项目时直接指定Admin面板的端口：

ADMIN_PORT=5174 npm run develop

或者在项目根目录创建.env.development文件，写入以下内容，后续启动会自动生效：

ADMIN_PORT=5174

方法2：正确配置Vite文件 #

1. 确认项目中存在src/admin/vite.config.js文件，没有的话手动创建。
2. 替换为正确的配置代码：

import { mergeConfig } from 'vite';

export default (config) => {
  return mergeConfig(config, {
    resolve: {
      alias: {
        '@': '/src',
      },
    },
    server: {
      port: 5174,
      hmr: {
        enabled: true,
        port: 5174,
      },
    },
  });
};

• 移除了无效的clientPort属性，只保留Vite支持的配置项
• HMR端口与server端口保持一致即可

3. 保存后重启项目：

npm run develop

额外排查点 #

如果还是出现端口占用提示：

• 检查5174端口是否被其他进程占用：Mac/Linux用lsof -i :5174，Windows用netstat -ano | findstr :5174，找到进程后杀掉
• 清理项目缓存：删除node_modules、.strapi文件夹，重新执行npm install后再启动

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