115 lines
3.2 KiB
Markdown
115 lines
3.2 KiB
Markdown
|
# VWED任务系统无窗口模式修复说明
|
|||
|
|
|
|||
|
|
## 问题描述
|
|||
|
|
在打包后的exe文件运行时，出现以下错误：
|
|||
|
|
```
|
|||
|
|
AttributeError: 'NoneType' object has no attribute 'isatty'
|
|||
|
|
ValueError: Unable to configure formatter 'default'
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 问题原因
|
|||
|
|
1. 在无窗口模式（console=False）下，Python的标准输入输出流（stdout/stderr/stdin）可能为None
|
|||
|
|
2. uvicorn的默认日志配置器尝试访问这些流的isatty()方法，导致AttributeError
|
|||
|
|
3. 这进一步导致日志配置失败
|
|||
|
|
|
|||
|
|
## 修复方案
|
|||
|
|
|
|||
|
|
### 1. 标准流重定向
|
|||
|
|
在`IntegratedLauncher.__init__()`中添加了`_setup_headless_mode()`方法：
|
|||
|
|
```python
|
|||
|
|
def _setup_headless_mode(self):
|
|||
|
|
"""设置无窗口模式的标准流重定向"""
|
|||
|
|
try:
|
|||
|
|
import io
|
|||
|
|
null_file = io.StringIO()
|
|||
|
|
|
|||
|
|
# 重定向标准流到空文件，避免None对象引起的问题
|
|||
|
|
if sys.stdout is None:
|
|||
|
|
sys.stdout = null_file
|
|||
|
|
if sys.stderr is None:
|
|||
|
|
sys.stderr = null_file
|
|||
|
|
if sys.stdin is None:
|
|||
|
|
sys.stdin = io.StringIO("")
|
|||
|
|
except Exception as e:
|
|||
|
|
pass
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. Uvicorn日志配置优化
|
|||
|
|
在无窗口模式下使用简化的uvicorn配置：
|
|||
|
|
```python
|
|||
|
|
if self.headless:
|
|||
|
|
# 无窗口模式：禁用reload、单worker、简化日志
|
|||
|
|
uvicorn.run(
|
|||
|
|
app, # 直接传递app对象而不是字符串
|
|||
|
|
host="0.0.0.0",
|
|||
|
|
port=port,
|
|||
|
|
reload=False,
|
|||
|
|
workers=1,
|
|||
|
|
access_log=False, # 禁用访问日志避免格式化问题
|
|||
|
|
log_config=None # 禁用默认日志配置
|
|||
|
|
)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. 分层错误处理
|
|||
|
|
添加了多层级的错误处理机制：
|
|||
|
|
1. 正常配置启动
|
|||
|
|
2. 如果失败，尝试简化配置
|
|||
|
|
3. 最后尝试最基本的启动模式
|
|||
|
|
|
|||
|
|
### 4. 启动脚本优化
|
|||
|
|
前台启动脚本优先使用调试版本，确保用户能看到详细信息：
|
|||
|
|
```batch
|
|||
|
|
if exist VWED_Task_System_Debug.exe (
|
|||
|
|
echo 使用调试版本启动以便查看详细信息...
|
|||
|
|
VWED_Task_System_Debug.exe
|
|||
|
|
) else (
|
|||
|
|
VWED_Task_System.exe
|
|||
|
|
)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 使用建议
|
|||
|
|
|
|||
|
|
### 开发和调试
|
|||
|
|
- 使用`启动VWED任务系统.bat`，会优先使用调试版本
|
|||
|
|
- 调试版本保留控制台窗口，便于查看错误信息
|
|||
|
|
|
|||
|
|
### 生产部署
|
|||
|
|
- 使用`后台启动服务.bat`进行后台部署
|
|||
|
|
- 日志记录在`vwed_service.log`文件中
|
|||
|
|
- 使用`检查服务状态.bat`监控服务状态
|
|||
|
|
|
|||
|
|
### 故障排除
|
|||
|
|
1. 如果后台启动失败，检查`vwed_service.log`文件
|
|||
|
|
2. 如果日志文件没有生成，尝试使用调试版本启动
|
|||
|
|
3. 确保config.ini配置文件正确
|
|||
|
|
4. 检查端口8000是否被占用
|
|||
|
|
|
|||
|
|
## 技术细节
|
|||
|
|
|
|||
|
|
### PyInstaller配置
|
|||
|
|
- 主程序：`console=False`，支持后台运行
|
|||
|
|
- 调试版本：`console=True`，保留控制台窗口
|
|||
|
|
|
|||
|
|
### 日志系统
|
|||
|
|
- 无窗口模式：所有日志输出到文件
|
|||
|
|
- 前台模式：同时输出到控制台和文件
|
|||
|
|
- 使用自定义的日志处理器避免uvicorn格式化问题
|
|||
|
|
|
|||
|
|
### 进程管理
|
|||
|
|
- PID文件：`vwed_service.pid`
|
|||
|
|
- 支持优雅关闭和强制停止
|
|||
|
|
- 进程状态检查和资源监控
|
|||
|
|
|
|||
|
|
## 验证方法
|
|||
|
|
运行测试脚本验证修复效果：
|
|||
|
|
```bash
|
|||
|
|
python packaging/test_headless.py
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 构建命令
|
|||
|
|
```bash
|
|||
|
|
cd packaging/scripts
|
|||
|
|
build_integrated.bat
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
这将生成完整的发布包，包含所有必要的启动脚本和工具。
|