日志目标未正确配置或未启用是 Yii2 中调用 Yii::debug() 等方法后日志不显示的主因；需按需配置 FileTarget、DbTarget、ConsoleTarget、EmailTarget 或自定义 FileTarget，并确保权限、组件依赖及表结构等条件满足。
如果您在 Yii2 应用中调用了 Yii::debug()、Yii::info() 等方法，但未在预期位置（如文件或数据库）看到日志内容，则很可能是日志目标（Target）未正确配置或未启用。以下是配置日志目标输出的具体方法：
一、启用 log 组件并配置 FileTarget
FileTarget 是最常用的目标类型，用于将日志写入 runtime/logs/ 目录下的文件。该目标需显式声明并加入 targets 数组，且必须确保 web 服务器进程对 runtime/logs/ 具有写权限。
1、在 config/web.php 的 components 配置块中添加 log 组件定义，并确保 'bootstrap' => ['log'] 已存在。
2、在 log 组件的 targets 数组中，加入一个 class 为 'yii\log\FileTarget' 的配置项。
3、设置 levels 指定捕获的日志级别（如 ['error', 'warning', 'info', 'trace', 'debug']），并可选配置 logFile 指向自定义路径（如 '@runtime/logs/debug.log'）。
4、确认 runtime/logs/ 目录存在且 web 用户（如 www-data 或 nginx）拥有写入权限。
二、配置 DbTarget 将日志存入数据库
DbTarget 可将日志消息持久化至数据库表，适用于需要结构化查询与长期归档的场景。其依赖预设的数据表结构，且需确保数据库连接组件已正确定义。
1、在 config/web.php 的 log 组件 targets 中添加 class 为 'yii\log\DbTarget' 的配置项。
2、指定 levels（如 ['error', 'warning']），并确保 db 组件已在 components 中正确定义且可用。
3、在项目根目录执行命令：./yii migrate --migrationPath=@yii/log/migrations/，以创建 {{%log}} 表。
4、若使用自定义表名或前缀，需在 DbTarget 配置中设置 logTable 属性（如 '{{%app_log}}'）。
三、启用 ConsoleTarget 输出至控制台
ConsoleTarget 专用于 CLI 环境（如命令行脚本或 cron 任务），将日志直接打印到终端 stdout，便于调试和即时观察执行流。
1、在 config/console.php 的 log 组件 targets 中添加 class 为 'yii\log\ConsoleTarget' 的配置项。
2、设置 levels 包含所需级别（如 ['info', 'error', 'debug']）。
3、运行命令时，日志将实时显示在终端，无需刷新或查看文件。
4、若需同时输出到控制台与文件，可在 targets 数组中并列配置 ConsoleTarget 和 FileTarget。
四、配置 EmailTarget 在异常时发送邮件通知
EmailTarget 用于在发生特定严重日志（如 error）时自动触发邮件告警，适用于生产环境关键故障响应。
1、在 log 组件 targets 中添加 class 为 'yii\log\EmailTarget' 的配置项。
2、配置 message 属性，设定邮件主题（如 'Yii2 Application Error Alert'）及 from/to 地址。
3、设置 levels 仅限 ['error']，避免警告或调试信息触发过多邮件。
4、确保应用已配置有效的 mailer 组件（如 smtp 或 phpmail），否则邮件发送将失败且无提示。
五、自定义 FileTarget 实现按模块分文件记录
默认 FileTarget 将所有日志写入同一文件，不利于按业务模块隔离分析。通过继承 yii\log\FileTarget 并重写 getLogFileName() 方法，可实现动态日志文件路径生成。
1、新建类文件 common/components/ModuleFileTarget.php，继承 yii\log\FileTarget。
2、重写 getLogFileName() 方法，根据 $message[2]（category）或 $message[0]（文本内容）提取模块标识（如 'api.auth'、'backend.user'）。
3、返回形如 @runtime/logs/{module}_{date}.log 的路径。
4、在 config/web.php 的 targets 中引用该类，class 设置为 'common\components\ModuleFileTarget'。
