Better Errors在非Rails应用中的完整使用指南
项目地址: https://gitcode.com/gh_mirrors/be/better_errors 想要在Sinatra、Hanami或其他Rack框架中获得与Rails同样强大的错误调试体验吗？Better Errors正是你需要的终极解决方案！这个优秀的Ruby gem为所有Rack应用程序提供了革命性的错误页面，让调试过程变得简单直观。🚀
为什么选择Better Errors进行错误调试
Better Errors彻底改变了传统Rack错误页面的体验，提供了极其丰富的调试功能。与普通错误页面相比，它能让你：
- 📍 快速定位问题 - 完整的堆栈跟踪和源码高亮显示
- 🔍 深入变量检查 - 本地变量和实例变量的实时查看
- 💻 交互式REPL - 在每个堆栈帧上运行实时shell
- 📝 编辑器直连 - 点击即可在编辑器中打开对应源码行
快速安装配置步骤
1. 添加Gem依赖
在你的Gemfile中添加以下内容：
group :development do
gem "better_errors"
gem "binding_of_caller"
end
binding_of_caller是可选的，但强烈建议安装，因为它提供了REPL、变量检查等高级功能。
2. 设置应用根目录
在非Rails应用中，你需要手动设置应用根目录：
BetterErrors.application_root = File.expand_path("..", __dir__)
在不同框架中的集成方法
Sinatra应用配置
在Sinatra应用中，只需在配置中添加中间件：
require "better_errors"
if development?
use BetterErrors::Middleware
BetterErrors.application_root = __dir__
end
纯Rack应用配置
对于纯Rack应用，在config.ru文件中配置：
require "better_errors"
if ENV["RACK_ENV"] == "development"
use BetterErrors::Middleware
BetterErrors.application_root = File.dirname(__FILE__)
end
核心功能深度解析
源码高亮与堆栈跟踪
Better Errors的CodeFormatter模块提供了专业的源码显示功能，支持HTML和文本两种格式的渲染。
实时变量检查
通过InspectableValue模块实现智能变量展示，自动过滤敏感信息。
交互式REPL系统
REPL模块支持多种后端，包括基础的Basic REPL和更强大的Pry REPL。
高级配置选项
编辑器链接配置
设置环境变量来配置编辑器链接：
export EDITOR="code"
Better Errors支持多种编辑器预设，包括TextMate、Sublime Text、MacVim、Atom等。
安全配置
重要提醒：Better Errors只能在开发环境中使用！请确保：
- 仅在development组中添加gem
- 不要在面向互联网的主机上运行
- 默认只允许localhost访问
常见问题解决方案
多进程服务器问题
在使用Unicorn、Puma等多worker服务器时，可能会出现"Session Expired"错误。解决方案：
- 在开发环境中将worker数设为1
- 或使用Webrick、Mongrel、Thin等单进程服务器
非HTML请求处理
Better Errors能智能识别XMLHttpRequest和非HTML请求，自动提供纯文本格式的错误信息。
性能优化技巧
变量检查限制
为避免性能问题，可以设置变量检查大小限制：
BetterErrors.maximum_variable_inspect_size = 100_000
忽略特定类
排除某些类的检查以提升性能：
BetterErrors.ignored_classes = ['ActionDispatch::Request', 'ActionDispatch::Response']
结语
Better Errors为所有Rack应用开发者提供了一个完整的错误调试解决方案。通过简单的中间件集成，你就能获得与Rails开发环境同样优秀的调试体验。无论是Sinatra、Hanami还是其他Rack框架，都能从中受益良�。🎯
立即在你的下一个项目中尝试Better Errors，体验前所未有的调试效率提升！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
