MathView加载Li⁺公式报StringIndexOutOfBoundsException如何解决

问题根因 #

你使用的io.github.kexanie.library:MathView:0.0.6依赖Chunk模板引擎渲染LaTeX内容，当传入的公式包含模板引擎保留的特殊字符时，引擎会错误将公式内容识别为模板标签，解析空标签时触发字符串索引越界崩溃。你遇到的Li⁺崩溃就是特殊字符触发了模板的异常解析逻辑。

修复方案 #

方案1：公式内容转义（侵入性最小，优先推荐） #

在调用setText前对LaTeX文本做转义处理，避免被模板引擎识别为标签，代码如下：

// 转义工具方法
private String escapeMathFormula(String rawFormula) {
    if (rawFormula == null || rawFormula.trim().isEmpty()) {
        return "";
    }
    // 替换Chunk模板引擎的保留特殊字符
    return rawFormula.replace("{", "{")
            .replace("}", "}")
            .replace("$", "$")
            .replace("`", "`");
}

// 调用时修改为
String txt = "Li⁺"; // 你的原始LaTeX公式
((MathView) lloption.findViewById(R.id.math0)).setText(escapeMathFormula(txt));

如果是LaTeX写法不规范导致的问题，建议将文本Li⁺改为标准LaTeX写法Li^+后再传入。

方案2：绕过模板引擎，直接控制WebView渲染（永久解决模板类崩溃） #

MathView本质是封装了WebView加载MathJax渲染引擎，你可以直接绕过setText的模板逻辑，自己拼接HTML内容加载：

MathView mathView = lloption.findViewById(R.id.math0);
try {
    // 反射获取MathView内部的WebView实例
    Field webViewField = MathView.class.getDeclaredField("webView");
    webViewField.setAccessible(true);
    WebView mathWebView = (WebView) webViewField.get(mathView);
    
    // 拼接MathJax渲染的HTML模板，直接加载
    String renderTemplate = "<!DOCTYPE html>\n" +
            "<html>\n" +
            "<head>\n" +
            "    <script type=\"text/javascript\"\n" +
            "            src=\"file:///android_asset/MathJax/MathJax.js?config=TeX-AMS-MML_HTMLorMML\">\n" +
            "    </script>\n" +
            "    <script type=\"text/x-mathjax-config\">\n" +
            "        MathJax.Hub.Config({showProcessingMessages: false,messageStyle: \"none\"});\n" +
            "    </script>\n" +
            "</head>\n" +
            "<body style=\"margin:0;padding:0;\">\n" +
            "    <p style=\"text-align:center;font-size:16px;\">%s</p>\n" +
            "</body>\n" +
            "</html>";
    String finalHtml = String.format(renderTemplate, txt);
    mathWebView.loadDataWithBaseURL(null, finalHtml, "text/html", "utf-8", null);
} catch (NoSuchFieldException | IllegalAccessException e) {
    e.printStackTrace();
}

方案3：修改依赖 #

你也可以fork原MathView项目源码，移除setText方法中的模板引擎依赖，直接拼接HTML后加载到WebView，从源码层面解决该问题；也可以更换为其他维护更活跃的Android端LaTeX渲染组件。

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