针对 FastDeploy 的日志系统进行优化，预计分 4 个 PR 完成。当前 PR 是第一个，新增日志相关参数和错误同时输出到终端，以提升调试体验和系统可观测性。
建议技术管理者和工程师关注此 PR 的日志系统优化方向，特别是 MaxLevelFilter 的设计和错误处理逻辑的改进。对于调试相关问题，值得精读 _read_latest_worker_traceback 函数的实现。
Review 中仅有一条评论，由 Jiang-Jia-Jun 提出，建议将 _read_latest_worker_traceback 函数的注释改为英文。这表明对代码风格和国际化的一致性要求。讨论简单，无其他争议或深度讨论。
实现分为几个关键部分：1) 在 envs.py 和相关文档中新增环境变量 FD_LOG_LEVEL、FD_LOG_REQUESTS 等；2) 在 setup_logging.py 中引入 MaxLevelFilter 并添加 console_stdout 和 console_stderr handlers，实现日志分流；3) 在 common_engine.py 中新增 _read_latest_worker_traceback 和 _format_worker_launch_failure_message 函数，优化 Worker 启动失败错误消息；4) 修改 engine.py 和 common_engine.py 中的错误处理逻辑，将错误输出到终端而非仅记录日志；5) 在 handlers.py 中确保日志目录存在；6) 添加相应单元测试。
| 文件 | 模块 | 状态 | 重要度 |
|---|---|---|---|
fastdeploy/engine/common_engine.py |
Engine | modified | 7.0 |
fastdeploy/logger/setup_logging.py |
Logger | modified | 6.0 |
fastdeploy/envs.py |
Env | modified | 5.0 |
tests/engine/test_common_engine.py |
Test | modified | 4.0 |
tests/engine/test_engine.py |
Test | added | 4.0 |
分析完成后，这里会展示 LLM 生成的相对完整源码片段和详细注释。
Jiang-Jia-Jun 建议将 _read_latest_worker_traceback 函数的注释改为英文。
结论：PR 已合并，可能已采纳建议。 · 已解决
主要风险包括：1) 新增环境变量当前未生效（PR body 中提到在后续 PR 中逐步使用），可能导致用户混淆；2) Worker 错误处理依赖文件系统读取 workerlog.* 文件，如果文件不存在或权限问题，可能无法获取 traceback；3) 日志输出分流可能影响现有日志收集工具，需确保兼容性；4) 测试覆盖率为 82.5%，有 7 行代码未覆盖，可能存在潜在 bug。
对用户：提供了更灵活的日志配置选项和更直观的错误输出，便于调试和监控。对系统：日志输出分流优化了终端显示，ERROR/CRITICAL 日志直接输出到 stderr 有助于快速识别问题。对团队：标准化了日志参数，为后续日志系统优化奠定基础，但需注意环境变量迁移（后续将删除 FD_DEBUG 和 TRACES_ENABLE）。
当前没有检测到明确关联的 Issue 链接，后续同步到相关引用后会出现在这里。
本 PR 作为 FastDeploy 日志系统优化的开端，新增了多个日志环境变量并优化了日志输出分流，将 INFO/DEBUG 日志定向到 stdout，ERROR/CRITICAL 定向到 stderr，同时改进 Worker 启动失败的错误展示，提升调试效率。
针对 FastDeploy 的日志系统进行优化，计划分 4 个 PR 完成。当前 PR 是第一部分，旨在新增日志相关参数和错误同时输出到终端，解决调试时日志信息不直观的问题，提升系统可观测性。PR body 中明确说明："针对 FastDeploy 的日志系统进行优化，预计分 4 个 pr 完成。"
fastdeploy/envs.py 和文档中添加 FD_LOG_LEVEL、FD_LOG_REQUESTS 等环境变量，为日志配置提供基础。fastdeploy/logger/setup_logging.py 中引入 MaxLevelFilter 类，并配置 console_stdout 和 console_stderr handlers，实现按级别分流。fastdeploy/engine/common_engine.py 中新增 _read_latest_worker_traceback 和 _format_worker_launch_failure_message 函数，读取 workerlog.* 文件中的 traceback 并格式化错误消息。fastdeploy/engine/engine.py 和 common_engine.py 中的 _stop_profile 等方法，将错误信息输出到终端而非仅记录日志。fastdeploy/logger/handlers.py 中为 DailyRotatingFileHandler._open() 添加 mkdir，确保日志目录存在。tests/engine/test_common_engine.py 和 test_engine.py，验证功能正确性。Review 中仅有一条评论，Jiang-Jia-Jun 指出 "使用英文注释"，强调代码风格的国际化一致性。讨论简单，无其他争议。
作为日志系统优化的第一部分，本 PR 为后续 PR（如日志通道划分、请求日志级别划分等）奠定基础。在历史 PR 中，虽无直接相关日志 PR，但近期 PR 如 #7052 涉及环境变量清理，显示团队对配置管理的重视，可视为间接关联。
参与讨论