Ruby网站邮件功能线上部署：tlsmail等Gem无法加载问题求助

看起来你遇到了共享主机环境下Ruby Gem加载的典型问题，结合你的场景，给你几个可行的解决方案：

1. 先确认主机环境的Gem安装状态 #

首先登录到你的主机终端（比如通过SSH），执行以下命令排查基础环境：

• 查看Ruby版本：ruby -v，确保和本地开发环境版本差异不大（避免兼容性冲突）
• 查看已安装的Gem：gem list，检查tlsmail、mail这些你需要的Gem是否已经安装

如果目标Gem未安装，共享主机通常不允许全局安装，你可以用用户级安装：

gem install tlsmail --user-install

安装后，Gem会存放在你用户目录下的.gem文件夹中。

2. 手动指定Gem加载路径 #

共享主机的默认Ruby加载路径可能不包含用户级安装的Gem，所以需要在脚本开头添加路径配置：

#!/usr/bin/ruby
puts "Content-type: text/html\n\n"

# 配置用户级Gem加载路径
require 'rubygems'
ruby_version = RUBY_VERSION.match(/\d+\.\d+/)[0] # 提取主版本号，比如2.7
gem_path = File.expand_path("~/.gem/ruby/#{ruby_version}/gems")
$LOAD_PATH.unshift(gem_path) unless $LOAD_PATH.include?(gem_path)

# 加载目标Gem
gem 'tlsmail'
require 'tlsmail'

# 后续的CGI和邮件处理代码...

3. 弃用tlsmail，用Ruby标准库的Net::SMTP（推荐） #

其实Ruby 1.9及以上版本的net/smtp已经原生支持TLS，不需要额外的tlsmailGem，之前你用Net::SMTP失败大概率是配置细节没做好。试试这个修正后的代码：

#!/usr/bin/ruby
puts "Content-type: text/html\n\n"
require "cgi"
require "net/smtp"
require "openssl"

cgi_request = CGI::new("html5")
contact_name = cgi_request["contact_name"]
contact_email = cgi_request["contact_email"]
contact_subject = cgi_request["subject"]
contact_message = cgi_request["contact_message"]

# 构建包含用户输入的邮件内容
msgstr = <<END_OF_MESSAGE
From: #{contact_name} <#{contact_email}>
To: A Private User <another-email@gmail.com>
Subject: #{contact_subject}

#{contact_message}
END_OF_MESSAGE

begin
  Net::SMTP.start("smtp.gmail.com", 587, "gmail.com", 
                  "mattiabombelli.noreply@gmail.com", "your_app_password", :plain) do |smtp|
    smtp.enable_starttls_auto # 启用自动TLS加密
    smtp.send_message msgstr, contact_email, "another-email@gmail.com"
  end
  puts "Email sent successfully!"
rescue StandardError => e
  # 捕获错误并输出，方便排查问题
  puts "Error sending email: #{e.message}"
end

注意：如果你的Gmail账号开启了两步验证，必须用应用专用密码代替普通登录密码；如果没开启两步验证，需要在Gmail设置中允许“不太安全的应用”（更推荐使用应用密码）。

4. 排查主机错误日志 #

如果还是无法解决，一定要查看主机的错误日志：

• Apache主机通常在/var/log/apache2/error.log或用户目录下的logs文件夹
• Nginx主机则是/var/log/nginx/error.log
  日志里会有具体的错误信息，比如Gem路径找不到、SMTP连接超时、权限不足等，这是定位问题最直接的方式。

5. 通用Gem加载技巧 #

以后在主机上加载Gem时，建议先执行require 'rubygems'（Ruby 1.9+可省略，但加上更稳妥），然后用gem 'gem_name'指定要加载的Gem，再执行require 'gem_name'，这样Ruby会自动处理路径匹配：

require 'rubygems'
gem 'mail' # 指定要加载的mail Gem
require 'mail'

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