Yii2 SwiftMailer生成.eml文件名错误且file_put_contents权限被拒

看起来你遇到了Yii2调试模式下SwiftMailer生成邮件文件的权限异常问题——明明有文件生成，却报了权限拒绝的错误，这种情况通常和目录权限、文件操作逻辑或者服务器配置有关，给你几个具体的排查方向：

• 检查目标目录的权限与所属用户
  首先确认/some/path/frontend/runtime/debug/mail目录的权限设置：

  • 执行命令ls -ld /some/path/frontend/runtime/debug/mail查看权限，至少需要保证Web服务器运行用户（比如Apache的www-data、Nginx/PHP-FPM的nginx或www-data）有写入权限（推荐权限为755，所属用户组匹配Web服务用户）。
  • 可以用ps aux | grep php-fpm或ps aux | grep apache确认Web服务的运行用户，再用chown -R www-data:www-data /some/path/frontend/runtime（替换为实际用户组）修正目录归属。

• 排查SwiftMailer的临时文件操作逻辑
  报错文件和实际生成的文件名称存在差异，大概率是因为SwiftMailer在生成邮件文件时，会先创建临时文件，再重命名到目标目录。如果临时目录（通常是系统临时目录或Yii runtime下的临时子目录）权限不足，或者重命名操作时目标目录的权限有问题，就会出现“文件已生成但报错”的情况。

  • 可以检查整个/some/path/frontend/runtime目录的权限，确保所有子目录都继承了正确的写入权限，避免局部目录权限不一致。

• 检查PHP的open_basedir限制
  如果服务器配置了open_basedir，需要确认/some/path/frontend/runtime在允许的路径列表中。可以通过phpinfo()查看open_basedir的配置项，如果目标目录不在列表内，PHP会限制写入操作，导致部分文件操作失败。

• 排除并发请求的文件命名冲突
  两个文件时间一致但名称不同，可能是并发请求导致的文件命名竞争——同一时间多个请求尝试生成邮件文件，其中一个在重命名时因为文件已存在或权限竞争报错。可以尝试在单请求场景下测试（比如直接访问触发邮件发送的页面，避免批量请求），看是否还会出现报错。

• 核对Mailer配置的完整性
  你提到配置文件中mailer的class是yii\swiftmailer\Mailer，建议确认完整配置：

  • 检查useFileTransport是否为true（调试模式默认开启），fileTransportPath是否正确指向@frontend/runtime/debug/mail（可以通过var_dump(Yii::$app->mailer->fileTransportPath)打印实际路径，确认是否和报错路径一致）。

• 临时测试方案（仅用于排查）
  可以临时给目标目录设置777权限（执行chmod -R 777 /some/path/frontend/runtime/debug/mail），如果设置后不再报错，说明确实是权限配置问题，之后再调整为更安全的权限（比如755）即可。

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