108 lines
2.5 KiB
Markdown
108 lines
2.5 KiB
Markdown
# Electron 端口自动查找功能
|
|
|
|
## 功能说明
|
|
|
|
Electron 应用启动时会自动在 9527-9999 端口范围内寻找可用端口，避免端口冲突问题。
|
|
|
|
## 工作原理
|
|
|
|
### 1. 端口检测
|
|
使用 Node.js 内置的 `net` 模块检测端口是否可用：
|
|
|
|
```javascript
|
|
function isPortAvailable(port) {
|
|
return new Promise((resolve) => {
|
|
const server = net.createServer()
|
|
server.listen(port, '127.0.0.1', () => {
|
|
server.once('close', () => resolve(true))
|
|
server.close()
|
|
})
|
|
server.on('error', () => resolve(false))
|
|
})
|
|
}
|
|
```
|
|
|
|
### 2. 端口查找
|
|
从 9527 开始向上查找，直到找到可用端口：
|
|
|
|
```javascript
|
|
async function findAvailablePort(startPort, maxPort) {
|
|
for (let port = startPort; port <= maxPort; port++) {
|
|
const available = await isPortAvailable(port)
|
|
if (available) {
|
|
return port
|
|
}
|
|
}
|
|
throw new Error(`No available port found between ${startPort} and ${maxPort}`)
|
|
}
|
|
```
|
|
|
|
### 3. 服务器启动
|
|
找到可用端口后启动 Express 服务器：
|
|
|
|
```javascript
|
|
const serverInfo = await startServer()
|
|
const { server, PORT } = serverInfo
|
|
```
|
|
|
|
## 配置参数
|
|
|
|
| 参数 | 默认值 | 说明 |
|
|
|------|--------|------|
|
|
| `START_PORT` | 9527 | 起始端口 |
|
|
| `MAX_PORT` | 9999 | 最大端口 |
|
|
|
|
## 使用示例
|
|
|
|
### 正常情况
|
|
```
|
|
✅ Local server running at http://127.0.0.1:9527
|
|
🚀 Loading app from: http://127.0.0.1:9527/index.html
|
|
```
|
|
|
|
### 端口冲突情况
|
|
```
|
|
🔒 Port 9527 is blocked
|
|
✅ Local server running at http://127.0.0.1:9528
|
|
🚀 Loading app from: http://127.0.0.1:9528/index.html
|
|
```
|
|
|
|
## 优势
|
|
|
|
1. **自动处理冲突** - 无需手动指定端口
|
|
2. **范围可控** - 限制在 9527-9999 范围内
|
|
3. **快速响应** - 端口检测速度快
|
|
4. **零依赖** - 使用 Node.js 内置模块
|
|
|
|
## 注意事项
|
|
|
|
1. **端口范围** - 如果 9527-9999 都被占用，会抛出错误
|
|
2. **监听地址** - 只监听 `127.0.0.1`，不暴露到外网
|
|
3. **服务器关闭** - 应用退出时会自动关闭服务器
|
|
|
|
## 测试
|
|
|
|
### 测试端口查找
|
|
```bash
|
|
node scripts/test-port-finder.cjs
|
|
```
|
|
|
|
### 测试端口冲突
|
|
```bash
|
|
node scripts/test-port-conflict.cjs
|
|
```
|
|
|
|
## 故障排查
|
|
|
|
### 端口范围耗尽
|
|
如果出现 "No available port found" 错误：
|
|
1. 检查是否有其他应用占用了大量端口
|
|
2. 增加 `MAX_PORT` 的值
|
|
3. 关闭不必要的应用释放端口
|
|
|
|
### 服务器启动失败
|
|
如果服务器启动失败：
|
|
1. 检查 dist 目录是否存在
|
|
2. 检查文件权限
|
|
3. 查看控制台错误信息
|