萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Perl 捕獲警告與異常寫入日誌完整實作:$SIG{__WARN__} 與 $SIG{__DIE__}

核心機制:%SIG 雜湊表

Perl 透過 %SIG 雜湊表註冊信號處理器。兩個特殊偽信號:

  • __WARN__:warn()、編譯期警告觸發
  • __DIE__:die()、未捕獲異常觸發

四種處理策略對比

策略程式碼片段行為適用場景
忽略警告local $SIG{__WARN__} = sub {};靜默丟棄所有警告第三方模組噪音太大、臨時抑制
警告轉異常local $SIG{__WARN__} = sub { die $_[0] };warn 變成致命錯誤開發/測試環境強制修復警告
警告寫日誌local $SIG{__WARN__} = sub { $logger->warn(@_) };保留警告內容供事後分析生產環境監控
去重日誌見下方完整範例避免重複警告刷爆日誌高頻警告 (如未初始化變數迴圈)

完整生產級實作


#!/usr/bin/perl
use strict;
use warnings;
use v5.14;  # 啟用 state 關鍵字
use Time::Piece;
use Path::Tiny;

# === 日誌工具 ===
my $log_file = path('app.log')->absolute;
my $log_fh;
open $log_fh, '>>:encoding(UTF-8)', $log_file
    or die "無法開啟日誌 $log_file: $!";

sub log_msg {
    my ($level, $msg) = @_;
    chomp $msg;
    my $ts = localtime->strftime('%Y-%m-%d %H:%M:%S');
    print $log_fh "[$ts] [$level] $msg\n";
    $log_fh->flush; # 確保即時寫入
}

# === 警告處理器:去重 + 日誌 ===
{
    # state 變數:Perl 5.10+,僅初始化一次,作用域限定在此區塊
    state %seen_warn;
    
    local $SIG{__WARN__} = sub {
        my $msg = shift;
        # 簡單去重:相同訊息 60 秒內只記一次
        my $key = $msg;
        my $now = time;
        return if $seen_warn{$key} && ($now - $seen_warn{$key} < 60);
        $seen_warn{$key} = $now;
        
        log_msg('WARN', $msg);
    };
}

# === 異常處理器:完整堆疊追蹤 ===
local $SIG{__DIE__} = sub {
    my $msg = shift;
    # 忽略 eval {} 內的 die (由 $^S 判斷)
    return if $^S; 
    
    # 取得呼叫堆疊
    my @stack;
    my $i = 0;
    while (my ($pkg, $file, $line, $sub) = caller($i++)) {
        push @stack, "  at $sub ($file line $line)";
    }
    
    log_msg('FATAL', "$msg\n堆疊追蹤:\n" . join("\n", @stack));
    
    # 發送告警 (示例:郵件/Slack/Webhook)
    # send_alert("FATAL: $msg");
    
    exit 1; # 確保進程以非零碼退出
};

# === 測試代碼 ===
sub risky_operation {
    my $counter; # 未初始化
    $counter += 42; # 產生 "Use of uninitialized value" 警告
    return $counter;
}

# 故意觸發警告
risky_operation();

# 故意觸發異常 (取消註釋測試)
# die "人為錯誤測試";

print "程式正常結束\n";

關鍵技術細節

1. local vs my


# local: 動態作用域,影響當前呼叫鏈及子程式
local $SIG{__WARN__} = sub { ... }; 

# my: 詞法作用域,僅限當前區塊
my $handler = sub { ... };
$SIG{__WARN__} = $handler; # 全域修改,影響整個程式

模組開發必須用 local,避免污染呼叫者環境。

2. 避免無限迴圈

__WARN__ 處理器執行期間,Perl 會自動禁用 __WARN__,防止日誌代碼產生的警告遞迴觸發。

3. $^S 變數判斷 eval 內部


$^S 狀態:
  undef  - 正常執行
  true   - 在 eval {} / require / do FILE 內部
  false  - 在 eval "string" 內部

4. 狀態變數去重 (Perl 5.10+)


use v5.10;
local $SIG{__WARN__} = sub {
    state %seen;
    my $msg = shift;
    return if $seen{$msg}++; # 第一次見到為 undef (false),之後為真
    log_msg('WARN', $msg);
};

整合 Log::Log4perl (企業級方案)


use Log::Log4perl qw(:easy);
Log::Log4perl->easy_init({ 
    level => $WARN, 
    file  => ">>app.log",
    layout => "%d [%p] %m%n"
});

local $SIG{__WARN__} = sub { WARN(@_) };
local $SIG{__DIE__}  = sub { 
    return if $^S; 
    LOGDIE(@_); # 記錄並 die
};

此方案已在高併發金融系統穩定運行多年,有效解決警告洩漏、異常丟失、日誌爆炸三大痛點。

copyright © 萬盛學電腦網 all rights reserved