应依次执行五步：一、重置basicconfig确保日志级别与格式统一；二、修正源码中logger实例化逻辑并设setlevel；三、注册全局异常钩子启用全堆栈捕获；四、替换streamhandler为rotatingfilehandler校验level字段；五、禁用第三方库日志污染，隔离deepseek命名空间。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在本地运行DeepSeek V4时发现日志中频繁输出\_level字段异常、日志级别混乱或堆栈信息缺失，可能是由于日志配置未正确映射日志等级，或异常捕获机制未启用完整堆栈打印。以下是解决此问题的步骤：
一、校验并重置logging.basicConfig配置
DeepSeek V4默认依赖Python标准logging模块，若未显式调用basicConfig或多次调用，会导致\_level字段解析失败、日志级别被覆盖或格式错乱。该方法通过强制初始化日志系统，确保level参数生效且格式统一。
1、确认当前脚本或入口文件中不存在重复的logging.basicConfig()调用，尤其是位于循环、子模块导入路径中的隐式调用。
2、在main.py或服务启动入口最顶部（import之后、任何日志语句之前）插入以下代码：
3、logging.basicConfig(level=logging.DEBUG, format='%(asctime)s - %(name)s - %(levelname)s - %(funcName)s:%(lineno)d - %(message)s', datefmt='%Y-%m-%d %H:%M:%S')
4、重启服务，观察控制台及日志文件中是否出现完整时间戳、函数名、行号及明确的DEBUG/INFO/ERROR标识。
二、修改deepseek源码中logger实例化逻辑
部分DeepSeek V4封装模块（如inference_server.py或api/router.py）内部使用了独立logger实例，绕过basicConfig全局设置，导致\_level字段始终为WARNING或NOTSET。该方法直接定位并修正日志器创建方式，强制绑定指定级别。
1、查找项目目录下所有包含logger = logging.getLogger(...)的Python文件，重点关注server/、api/、utils/子目录。
2、对每个匹配行，检查其后是否调用setLevel()；若无，则在其下方添加：logger.setLevel(logging.DEBUG)。
3、若发现logger被命名为'__main__'或空字符串，替换为具名实例，例如：logger = logging.getLogger('deepseek.inference')。
4、禁止使用logger.disabled = True或logger.propagate = False，否则将导致\_level字段丢失或堆栈不输出
三、启用异常全堆栈捕获与结构化记录
默认情况下，DeepSeek V4在捕获Exception时可能仅记录str(e)，丢失traceback对象，造成堆栈信息截断。该方法通过定制异常处理器，确保每条ERROR日志均附带完整traceback.format_exc()内容，并保留原始\_level字段语义。
1、在服务初始化阶段（如FastAPI的startup事件或Flask的before_first_request钩子）中注册全局异常钩子：
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
2、插入以下代码块：
3、import traceback; import logging; logger = logging.getLogger('deepseek.error'); def handle_exception(exc_type, exc_value, exc_traceback): logger.error("Uncaught exception", exc_info=(exc_type, exc_value, exc_traceback)); sys.excepthook = handle_exception
4、验证方式：手动触发一个RuntimeError（如在任意路由中raise RuntimeError("test stack")），检查日志是否包含完整的File "/path/to/file.py", line X, in func_name堆栈路径。
四、替换默认Handler为RotatingFileHandler并注入level字段校验
当使用StreamHandler时，某些终端环境会过滤或重写levelname字段，导致\_level显示为空或错误值。RotatingFileHandler可绕过终端干扰，并支持自定义Formatter，在输出前校验并强制补全\_level字段。
1、删除所有logging.StreamHandler()相关代码，改用RotatingFileHandler：
2、添加如下配置：
3、handler = RotatingFileHandler('deepseek_v4.log', maxBytes=10485760, backupCount=5); formatter = logging.Formatter('%(asctime)s | %(levelname)s | %(name)s | %(funcName)s:%(lineno)d | %(message)s'); handler.setFormatter(formatter); logger.addHandler(handler)
4、启动后检查日志文件首行是否严格以“| ERROR |”或“| DEBUG |”开头，确认\_level字段已稳定落盘。
五、禁用第三方库日志污染并隔离deepseek命名空间
requests、transformers、torch等依赖库会注册自己的root logger，其默认WARNING及以上级别日志会冲刷deepseek的\_level字段，造成混淆。该方法通过显式禁用非deepseek命名空间日志器，确保仅deepseek相关模块输出可控日志。
1、在basicConfig之后立即执行：
2、logging.getLogger('requests').setLevel(logging.WARNING); logging.getLogger('urllib3').setLevel(logging.WARNING); logging.getLogger('transformers').setLevel(logging.ERROR); logging.getLogger('torch').setLevel(logging.ERROR)
3、仅对deepseek专属logger开启DEBUG：
4、logging.getLogger('deepseek').setLevel(logging.DEBUG); logging.getLogger('deepseek.model').setLevel(logging.DEBUG)
