70 lines
1.9 KiB
Markdown
70 lines
1.9 KiB
Markdown
|
# 迷你收银台系统 - 稳定启动方案
|
|||
|
|
|
|||
|
|
## 问题分析
|
|||
|
|
经过排查，发现系统之前闪退的主要原因：
|
|||
|
|
1. 批处理文件使用了复杂的中文语法，导致编码问题
|
|||
|
|
2. 缺少端口冲突检测和清理
|
|||
|
|
3. 导航菜单功能需要修复
|
|||
|
|
|
|||
|
|
## 已完成的修复
|
|||
|
|
|
|||
|
|
1. **导航菜单修复**：
|
|||
|
|
- 增强了Layout.js中的菜单点击处理函数
|
|||
|
|
- 添加了错误处理和备选导航方案
|
|||
|
|
- 添加了详细的调试日志
|
|||
|
|
|
|||
|
|
2. **启动脚本优化**：
|
|||
|
|
- 修复了批处理文件的编码问题，添加了`chcp 65001`命令确保UTF-8编码
|
|||
|
|
- 添加了端口冲突检测和自动清理功能
|
|||
|
|
- 使用英文命令避免编码问题
|
|||
|
|
- 优化了错误处理机制
|
|||
|
|
|
|||
|
|
## 使用方法
|
|||
|
|
|
|||
|
|
### 方法一：使用极简启动脚本（推荐）
|
|||
|
|
1. 双击运行 `minimal-start.bat`
|
|||
|
|
2. 系统会自动清理端口冲突并启动服务
|
|||
|
|
3. 服务器已成功运行在端口 3000
|
|||
|
|
|
|||
|
|
### 方法二：手动启动步骤
|
|||
|
|
1. 打开命令提示符（管理员权限）
|
|||
|
|
2. 切换到项目目录：`cd d:\workspace\minishouyin`
|
|||
|
|
3. 清理端口：`for /f "tokens=5" %a in ('netstat -aon ^| findstr ":3000"') do taskkill /f /pid %a 2> NUL`
|
|||
|
|
4. 启动服务：`npm start`
|
|||
|
|
|
|||
|
|
## 故障排除
|
|||
|
|
|
|||
|
|
如果仍然遇到闪退问题：
|
|||
|
|
|
|||
|
|
1. **检查依赖是否完整**：
|
|||
|
|
```
|
|||
|
|
npm install --force
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
2. **清理缓存**：
|
|||
|
|
```
|
|||
|
|
npm cache clean --force
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
3. **检查Node.js版本**：
|
|||
|
|
确保使用稳定版Node.js（推荐v14.x或v16.x）
|
|||
|
|
|
|||
|
|
4. **检查数据库文件权限**：
|
|||
|
|
确保data目录有读写权限
|
|||
|
|
|
|||
|
|
5. **查看详细错误日志**：
|
|||
|
|
错误日志保存在 `datalogs` 目录下
|
|||
|
|
|
|||
|
|
## 特别说明
|
|||
|
|
|
|||
|
|
- 系统已经成功启动并稳定运行
|
|||
|
|
- 菜单导航功能已修复
|
|||
|
|
- 如需再次启动，请使用 `minimal-start.bat`
|
|||
|
|
- 如果出现端口占用，脚本会自动清理
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
**注意事项**：
|
|||
|
|
1. 请勿删除 `minimal-start.bat`，这是当前稳定启动的关键
|
|||
|
|
2. 避免使用中文路径
|
|||
|
|
3. 如需修改端口，请编辑 `server-port.json` 文件
|