Email::Simple模块substr引用左值警告问题排查求助

问题背景 #

正在开发从服务器提取邮件主题、正文、附件等信息的项目，运行Perl代码时触发警告：Attempt to use reference as lvalue in substr at /usr/share/perl5/vendor_perl/Email/Simple.pm line 87。该警告来自代码行my $email = Email::MIME->new(\$rawmail);，涉及模块版本为Email::Simple v2.216（第87行代码为$head = substr $$text_ref, 0, $pos, '';）、Email::MIME v1.954，运行环境为Perl 5.26.3 + AlmaLinux 8.10。

具体成因 #

1. Perl版本的规则收紧：Perl 5.26版本对变量作为左值（lvalue）的使用逻辑进行了严格检查，当尝试将引用解引用后的变量直接作为substr的第四个替换参数时，会触发该警告。Email::Simple v2.216中的目标代码行，$$text_ref是对传入标量引用的解引用，这种用法在Perl 5.26中被判定为不安全的左值引用操作。
2. 模块兼容性bug：这是Email::Simple模块与Perl 5.26及以上版本的兼容性问题，属于模块已知bug。
3. 参数传递方式触发问题：代码中使用Email::MIME->new(\$rawmail)传递标量引用，而非直接传入字符串$rawmail，触发了模块内部的问题逻辑。直接传递字符串可绕过该警告（需验证是否影响邮件解析功能）。

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