从PHP转Python的开发者：Python是否有类PHP的错误日志及error_log函数？

刚从PHP转Python的时候我也有过同样的困惑——PHP自带的全局错误日志和error_log()函数简直是调试神器，尤其是处理cron脚本的时候！别担心，Python虽然没有完全一样的开箱即用机制，但有更灵活的替代方案，完全能解决你的问题。

先解决你的紧急问题：cron脚本崩溃的调试 #

你的脚本在命令行正常、cron里偶尔崩溃，大概率是cron默认会丢弃脚本的输出和错误信息，导致你看不到崩溃原因。最快的临时解决方法是在cron命令里重定向标准输出和错误到日志文件：

# 把cron任务改成这样，替换路径为你自己的脚本和日志路径
* * * * * /usr/bin/python3 /path/to/your/script.py >> /var/log/script_cron.log 2>&1

解释一下：

• >> 是把标准输出（stdout）追加到日志文件
• 2>&1 是把标准错误（stderr，也就是脚本崩溃时的报错信息）重定向到和标准输出一样的文件
  这样不管脚本是正常输出还是崩溃报错，所有内容都会存在script_cron.log里，你直接看对应时间的日志就能找到崩溃原因了。

对标PHP的error_log()：Python的logging模块 #

Python标准库的logging模块是处理日志的首选，功能比PHP的error_log()强大得多——你可以配置日志级别、输出格式、存储位置，甚至同时输出到文件和控制台。

基础配置：记录错误到文件 #

这是最接近PHP全局错误日志的用法，配置后所有ERROR及以上级别的日志都会写入文件：

import logging

# 配置日志：写入文件、设置级别、定义格式
logging.basicConfig(
    filename='/var/log/python_script_errors.log',
    level=logging.ERROR,  # 只记录ERROR和更严重的CRITICAL日志
    format='%(asctime)s - %(levelname)s - %(message)s',
    datefmt='%Y-%m-%d %H:%M:%S'  # 自定义时间格式
)

# 主动记录错误，类似PHP的error_log("出错了")
try:
    # 你的业务代码，比如可能崩溃的逻辑
    result = 45 / 0
except Exception as e:
    # 记录错误信息，exc_info=True会打印完整堆栈轨迹（非常适合调试）
    logging.error(f"执行除法操作失败: {str(e)}", exc_info=True)

更灵活的配置 #

如果需要区分不同级别的日志（比如调试信息、普通信息、错误），可以进阶配置：

import logging

# 创建日志对象
logger = logging.getLogger(__name__)
logger.setLevel(logging.DEBUG)  # 最低记录级别为DEBUG

# 创建文件处理器，写入日志文件
file_handler = logging.FileHandler('/var/log/script_full.log')
file_handler.setLevel(logging.DEBUG)

# 创建格式器
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
file_handler.setFormatter(formatter)

# 添加处理器到日志对象
logger.addHandler(file_handler)

# 不同级别的日志记录
logger.debug("这是调试信息，比如变量值")
logger.info("脚本开始执行")
logger.warning("注意：某个参数可能有问题")
logger.error("发生了错误，但脚本还能继续跑")
logger.critical("严重错误，脚本必须终止")

极简方案：直接重定向标准错误 #

如果你不想用logging模块，也可以直接把Python的标准错误（stderr）定向到文件，这样所有未捕获的异常都会自动写入文件：

import sys

# 打开日志文件，以追加模式写入
sys.stderr = open('/var/log/script_stderr.log', 'a')

# 之后任何未捕获的异常都会写到这个文件里
# 比如下面的代码会触发ZeroDivisionError，错误信息会被写入日志
1 / 0

不过这个方法比较简陋，没法区分日志级别，适合临时应急。

额外提醒：cron环境的坑 #

脚本在命令行正常、cron跑失败，除了日志问题，还要注意环境变量差异：

• cron的PATH通常比命令行的PATH短，所以最好用Python的绝对路径（比如/usr/bin/python3）调用脚本
• 在脚本开头加shebang行：#!/usr/bin/env python3，然后给脚本加执行权限：chmod +x /path/to/your/script.py，这样cron里可以直接写/path/to/your/script.py而不用加python前缀
• 如果脚本依赖第三方库，cron可能找不到，最好用虚拟环境的Python路径调用，比如/path/to/venv/bin/python3

内容的提问来源于stack exchange，提问作者Chris Utter