Ruby 1.9.3中ActionView::TemplateError「invalid byte sequence in US-ASCII」错误如何解决？

开发者阿泽

2026-7-14

解决Ruby 1.9.3迁移后ERB文件的「invalid byte sequence in US-ASCII」错误

针对你迁移后ERB文件因瑞典字符出现的编码错误，可按以下步骤逐一排查解决：

给ERB文件添加编码声明
在每个报错的ERB文件开头添加编码注释：
```
<%# encoding: utf-8 %>
```
Ruby 1.9+会通过这个注释识别模板文件的编码，确保解析时正确处理瑞典字符（如å、ä、ö）。
设置全局默认编码
在config/application.rb或config/environment.rb中添加全局编码配置，覆盖Ruby默认的US-ASCII：
```
Encoding.default_external = Encoding::UTF_8
Encoding.default_internal = Encoding::UTF_8
```
这会让整个应用（包括模板渲染、文件读取、字符串处理）默认使用UTF-8编码，从根源减少编码冲突。
检查ERB文件的实际保存编码
确保所有ERB文件是以UTF-8无BOM格式保存的。部分编辑器（如Windows记事本）默认会给UTF-8文件添加BOM头，这会导致Ruby解析时识别错误。可以用VS Code、Sublime Text等编辑器打开文件，将编码设置为「UTF-8无BOM」后重新保存。
确认数据库连接编码
如果ERB中的瑞典字符来自数据库，需在config/database.yml中指定数据库连接编码（以MySQL为例）：
```
development:
  adapter: mysql2
  encoding: utf8mb4
  # 其他配置...
```
确保数据库存储和读取的数据都是UTF-8编码，避免模板渲染时出现编码不匹配。
应急处理特定字符串
如果某段字符串明明是UTF-8却被标记为US-ASCII，可以临时用force_encoding修正：
```
str = str.force_encoding('UTF-8')
```
但这只是临时解决方案，建议优先从前面的步骤解决根源问题。