diff --git a/backend/package/yuxi/utils/logging_config.py b/backend/package/yuxi/utils/logging_config.py
index 4b909fb7..5030d5ac 100644
--- a/backend/package/yuxi/utils/logging_config.py
+++ b/backend/package/yuxi/utils/logging_config.py
@@ -53,10 +53,14 @@ def setup_logger(name, level="DEBUG", console=True):
loguru_logger.remove()
# 添加文件日志(无颜色)
+ # 末尾追加 {extra}:loguru 会将通过 bind(**kwargs) 传入的附加上下文
+ # (如 trace_id/error_type/error_message)合并到 record 的 extra 字典,
+ # format 显式引用 {extra} 才能输出,否则 kwargs 会被静默丢弃,导致
+ # stage 失败、投递失败等错误链路看不到具体异常类型与消息。
loguru_logger.add(
LOG_FILE,
level=level,
- format="{time:YYYY-MM-DD HH:mm:ss} - {level} - {file}:{line} - {message}",
+ format="{time:YYYY-MM-DD HH:mm:ss} - {level} - {file}:{line} - {message} {extra}",
encoding="utf-8",
rotation="10 MB",
retention="30 days",
@@ -74,6 +78,7 @@ def setup_logger(name, level="DEBUG", console=True):
"{level} "
"{file}:{line}: "
"{message}"
+ " {extra}"
),
colorize=True,
enqueue=True,