使用PhantomJS导出渲染内联HTML时Ruby on Rails报UTF-8格式错误

Hey there! Let's work through this UTF-8 template error you're facing when exporting inline HTML using PhantomJS in Ruby on Rails. I've dealt with similar encoding headaches before, so here are actionable steps to resolve it:

1. Verify Your Template File's Encoding #

First things first—make sure your ERB/HAML template file is actually saved as UTF-8. A lot of issues start here, especially if you're using a text editor that defaults to other encodings (looking at you, Windows Notepad!).

• In editors like VS Code or Sublime Text, check the encoding indicator in the bottom-right corner. If it's not UTF-8, click it and select "Save with Encoding > UTF-8" (skip the BOM option—Rails doesn't need it).
• You can also verify via the command line:

  file -I app/views/your_template.html.erb
  

  Look for charset=utf-8 in the output. If you see something else (like charset=iso-8859-1), that's the problem.

2. Force UTF-8 Encoding When Rendering Templates #

Tell Rails explicitly to render your template with UTF-8 encoding. Add the encoding option when using render_to_string in your controller:

def export
  # Render the template with explicit UTF-8 encoding
  html_content = render_to_string(
    template: 'path/to/your/template',
    encoding: 'UTF-8'
  )
  # Pass html_content to PhantomJS for export
end

If you're working with an inline HTML string directly, ensure it's properly encoded:

inline_html = "<h1>Your Inline HTML</h1>".force_encoding('UTF-8')

3. Configure PhantomJS to Use UTF-8 #

PhantomJS might be picking up your system's default encoding instead of UTF-8. Fix this in two ways:

• In your PhantomJS script: When setting the page content, specify the encoding:

  page.setContent(htmlContent, 'https://your-app-url.com', { encoding: 'utf-8' });
  

• When invoking PhantomJS: Add the encoding flag to your command line call:

  phantomjs --output-encoding=utf-8 your_export_script.js
  

4. Clean Invalid UTF-8 Characters in Templates #

If your template has hidden invalid bytes (from copying/pasting text from non-UTF-8 sources), use iconv to strip them out:

iconv -f UTF-8 -t UTF-8 -c app/views/your_template.html.erb > cleaned_template.html.erb

The -c flag removes any characters that aren't valid UTF-8. Just replace the original file with the cleaned version after verifying it looks correct.

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