Yii 1.1中Yii::log()无法正常写入日志文件的问题排查

核心原因1：Yii日志的延迟写入机制 #

Yii 1.1默认采用日志缓存批量写入的机制：

• CLogger组件的autoFlush默认值为1000，意味着只有当日志消息积累到1000条时才会自动刷新到文件。
• 未达到阈值时，日志会暂存在内存中，直到应用触发onEndRequest事件（请求正常结束）时才会一次性写入。

如果代码中存在提前终止请求的操作（比如exit()、die()、Yii::app()->end()），onEndRequest事件不会被触发，内存中缓存的日志就无法写入文件，导致仅第一条日志（可能是缓存残留或刚好触发某次刷新）显示，后续日志丢失。

而数据库操作（如$thing->save()）是即时执行的，不需要等待请求结束，因此会出现数据库已更新，但日志未写入的矛盾现象。

核心原因2：日志文件权限或滚动配置问题 #

• 权限不足：日志文件写入第一条后，权限发生变化（比如被改为只读），导致后续日志无法写入。
• 日志滚动：CFileLogRoute的maxFileSize设置过小，日志文件很快被填满，自动生成带后缀的新日志文件，你可能一直在查看旧的日志文件，遗漏了新日志内容。

矛盾现象（日志显示else分支但数据库更新）的可能原因 #

1. 测试数据不一致：第二次修改代码后，查询条件status='false'未匹配到数据，日志显示thing is null是正确的，但数据库中的更新是之前测试的遗留结果，并非本次执行的操作。
2. 文件缓存：操作系统或文本编辑器缓存了旧的日志内容，新日志已写入但未实时显示，可通过查看日志文件的修改时间验证。

解决方法 #

1. 修改日志组件配置，强制即时写入 #

在protected/config/main.php中调整日志配置，将autoFlush设为1，确保每条日志立即写入：

'components' => array(
    'log' => array(
        'class' => 'CLogRouter',
        'autoFlush' => 1, // 每条日志立即刷新到文件
        'routes' => array(
            array(
                'class' => 'CFileLogRoute',
                'levels' => 'dev', // 确保包含你使用的日志级别
                'categories' => 'My.Code.Example', // 确保包含你的日志分类
                'logFile' => 'my_app.log', // 可指定日志文件名，方便查找
            ),
        ),
    ),
),

2. 手动触发日志刷新 #

在关键日志写入后，手动调用flush方法强制写入：

Yii::log('foo(): thing is not null', 'dev', 'My.Code.Example');
Yii::app()->log->flush(true); // true表示立即写入

3. 避免请求提前终止 #

将代码中的exit()、die()或Yii::app()->end()替换为Yii::app()->end(false)，参数false表示完成请求收尾工作（包括写入日志）后再终止：

// 替换前
Yii::app()->end();
// 替换后
Yii::app()->end(false);

4. 检查日志文件权限与滚动配置 #

• 确保Web服务器用户（如www-data、apache）对日志目录有写入权限。
• 调整maxFileSize参数，避免频繁滚动：

array(
    'class' => 'CFileLogRoute',
    'maxFileSize' => 1024, // 单位KB，默认1024，可按需增大
),

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