Documentation for JIRA 4.0. Documentation for other versions of JIRA is available too.

Skip to end of metadata
Go to start of metadata

Some users report having problem parsing unicode-1-1-utf-7 (aka utf-7) emails. JIRA breaks with a stacktrace like:

2007-01-31 12:54:59,176 JiraQuartzScheduler_Worker-2 ERROR [service.util.handler.CreateIssueHandler] Could not create issue! unicode-1-1-utf-7
at sun.nio.cs.StreamDecoder.forInputStreamReader(
at com.sun.mail.handlers.text_plain.getContent(
at javax.activation.DataSourceDataContentHandler.getContent(
at javax.activation.DataHandler.getContent(
at javax.mail.internet.MimeBodyPart.getContent(
at com.atlassian.jira.service.util.handler.AbstractMessageHandler.handleMultipart(
at com.atlassian.jira.service.util.handler.AbstractMessageHandler.createAttachmentsForMessage(
at com.atlassian.jira.service.util.handler.CreateIssueHandler.handleMessage(
at com.atlassian.jira.service.util.handler.CreateOrCommentHandler.handleMessage(
at com.atlassian.jira.service.ServiceRunner.execute(
at org.quartz.simpl.SimpleThreadPool$

The solution

Hopefully one day, Sun will include support for this encoding natively (see this Sun bug report, but in the meanwhile you can install a library to get this working. Installation is quite simple:

  1. Download the jutf7 jar from
  2. Copy the jar to your $JAVA_HOME/jre/lib/ext directory. No other directory will do - it has to be in this (lowest)classloader to be picked up.
  3. Restart JIRA (or Confluence, or whatever is parsing the emails).
  • No labels