Rails 5应用文件上传报错无日志，如何排查调试？

一、强制显示详细错误信息 #

• 修改测试服务器的config/environments/production.rb：
  • 设置config.consider_all_requests_local = true，这会替换通用错误页为详细的Rails错误追踪页面，调试完成后记得改回false
  • 确保config.log_level = :debug，让日志记录更详尽
• 重启服务生效：sudo systemctl restart passenger nginx

二、排查系统权限问题 #

• 检查Rails临时上传目录权限：运行ls -ld /path/to/your/app/tmp/cache，确认Passenger运行用户（通常是nginx或部署用户）拥有读写权限，权限不足则执行sudo chown -R nginx:nginx /path/to/your/app/tmp（根据实际用户调整）
• 检查文件存储目录权限：如果用CarrierWave/Paperclip等上传gem，确认public/uploads或自定义存储目录的权限符合要求
• 检查SELinux设置（RHEL7特有）：
  • 执行getsebool -a | grep httpd，查看httpd_can_write_files和httpd_can_network_connect是否为on
  • 未开启则执行sudo setsebool -P httpd_can_write_files on和sudo setsebool -P httpd_can_network_connect on

三、检查Nginx上传配置 #

• 查看Nginx站点配置或nginx.conf，确认client_max_body_size设置足够（默认1M可能无法满足大文件上传），例如修改为client_max_body_size 10M;
• 查看Nginx错误日志：tail -f /var/log/nginx/error.log，这里可能记录了文件上传时的请求超限、权限等问题

四、构建最小测试用例 #

• 创建一个极简的测试控制器和视图，排除业务逻辑干扰：
  • 控制器代码：

    class TestUploadsController < ApplicationController
      def new; end
    
      def create
        logger.debug "上传文件详情：#{params[:test_file].inspect}"
        render plain: "文件接收成功"
      end
    end
    

  • 视图test_uploads/new.html.erb：

    <%= form_tag test_uploads_path, multipart: true do %>
      <%= file_field_tag :test_file %>
      <%= submit_tag "测试上传" %>
    <% end %>
    

  • 配置路由：post 'test_uploads', to: 'test_uploads#create'
  • 提交测试后查看Rails日志，判断基础上传功能是否正常

五、核对Passenger运行环境 #

• 检查Passenger进程用户：ps aux | grep passenger，确认和生产服务器运行用户一致
• 核对环境变量：执行passenger-status查看运行环境，确保RAILS_ENV等关键变量和生产环境一致
• 重新安装依赖：执行bundle install --deployment，确保测试服务器的gem版本和生产服务器完全匹配（参考Gemfile.lock）

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