Ruby中无法通过Outlook发邮件：IRB可行但脚本执行报错

这个错误的核心很明确：Outlook无法识别你指定的一个或多个收件人/抄送人/密送人名称，虽然IRB里能正常运行，但脚本环境和IRB的执行场景有差异，导致了这个问题。下面是一步步的排查和解决方法：

1. 先确认收件人的格式是否正确 #

Outlook识别收件人只认两种可靠格式：

• 完整的邮箱地址（比如john.doe@company.com），这种是最稳妥的，不会有匹配问题
• 通讯录里完全精确匹配的显示名称（比如通讯录里存的是"John Doe"，你就不能写"John"或者"Doe"）

如果你的代码里用了模糊的名称或者拼写错误的名称，Outlook就会报这个错。比如把message1.Recipients.Add("John Doe")改成message1.Recipients.Add("john.doe@company.com")试试，大概率能解决问题。

2. 显式解析收件人，提前排查问题 #

直接调用Add方法添加收件人时，Outlook会自动尝试解析，但如果解析失败不会立刻报错，直到调用Send才会炸。可以在代码里手动解析收件人，提前发现问题：

# 假设你正在添加收件人
recipient = message1.Recipients.Add("john.doe@company.com")
# 手动触发解析
resolve_status = recipient.Resolve
if !resolve_status
  puts "警告：无法解析收件人 #{recipient.Name}，请检查名称或邮箱地址"
  # 这里可以选择终止脚本或者更换收件人
  exit 1
end

这样就能在发送前就定位到无效的收件人，避免Send时的报错。

3. 检查脚本的执行环境 #

IRB是在你当前登录的用户会话下运行的，而如果你的脚本是通过任务计划、服务或者其他用户权限运行的，Outlook的通讯录可能和IRB里的不一样。确保脚本和IRB在同一个用户环境下执行，比如不要用管理员权限运行脚本，除非你IRB也是用管理员权限打开的。

4. 排除Outlook缓存或状态问题 #

有时候Outlook的联系人缓存会导致解析失败，你可以：

• 重启Outlook后再运行脚本
• 打开Outlook的联系人列表，确认你用的收件人名称确实存在且唯一
• 清空Outlook的自动完成缓存（文件 → 选项 → 邮件 → 发送邮件 → 清空自动完成列表）

5. 完整的示例代码 #

把上面的步骤整合起来，一个可靠的发邮件脚本应该是这样的：

require 'win32ole'

def send_outlook_email(to_recipients, subject, body)
  begin
    outlook = WIN32OLE.new('Outlook.Application')
    mail_item = outlook.CreateItem(0) # 0 = olMailItem

    # 处理每个收件人
    to_recipients.each do |recipient|
      addr = mail_item.Recipients.Add(recipient)
      unless addr.Resolve
        raise "无法解析收件人：#{recipient}"
      end
    end

    mail_item.Subject = subject
    mail_item.Body = body

    # 如果需要手动确认邮件，可以用Display代替Send
    # mail_item.Display
    mail_item.Send
    puts "邮件发送成功！"
  rescue WIN32OLERuntimeError => e
    puts "发送失败：#{e.message}"
  rescue => e
    puts "其他错误：#{e.message}"
  end
end

# 调用示例：用邮箱地址或者可解析的联系人名称
send_outlook_email(
  ['alice@example.com', 'bob@company.com'],
  '自动化测试邮件',
  '这是通过Ruby脚本发送的测试内容'
)

最后排查小技巧 #

如果还是有问题，把脚本里的收件人变量单独拿出来在IRB里测试，对比两者的传入值是否完全一致——比如脚本里读取的收件人数据有没有多余的空格、换行符或者特殊字符，这些都会导致Outlook解析失败。

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