通过下文的介绍，相信您一定会找到答案。
一、  Freemarker中list指令简单介绍
要想在Freemarker中遍历list,必须通过使用list指令,即<#list sequence as item>…</#list>
sequence是集合(collection)的表达式，item是循环变量的名字，不能是表达式。
当在遍历sequence时，会将遍历变量的值保存到item中。
举个例子说明吧：
<#list userList as user>
…
</#list>
userList中封装了很多个User对象，我们在遍历userList时候，会将遍历的User对象的值，保存到上述的user变量中。那么在取值时，我们可以通过${user.userName }来获取User对象的userName属性值。
List指令还隐含了两个循环变量：
item_index:当前迭代项在所有迭代项中的位置，是数字值。
item_has_next:用于判断当前迭代项是否是所有迭代项中的最后一项。
注意：在使用上述两个循环变量时，一定要将item换成你自己定义的循环变量名,item其实就是前缀罢了。
例如，如果你使用<# list list as l>..</#list>定义，那么就要使用l_index,l_has_next。

在循环过程中，如果您想跳出循环，那么可以使用结合break指令，即<#break>来完成。
二、  Freemarker中对List进行排序
通常我们的排序操作都是通过DAO层来实现的，如果我们想随时更改我们的排序，那么就必须修改我们的DAO层代码，确实不方便。但Freemarker为我们提供了这样的排序方法，解决了这个问题。
1.  sort升序排序函数
sort对序列(sequence)进行排序，要求序列中的变量必须是：字符串（按首字母排序）,数字，日期值。
<#list list?sort as l>…</#list>
2.  sort_by函数
sort_by有一个参数,该参数用于指定想要排序的子变量，排序是按照变量对应的值进行排序,如：
<#list userList?sort_by(“age”) as user>…</#list>
age是User对象的属性，排序是按age的值进行的。
3.  reverse降序排序函数
<#list list? reverse as l>…</#list>。reverse使用同sort相同。reverse还可以同sort_by一起使用
如：想让用户按年龄降序排序，那么可以这个样写<#list userList?sort_by(“age”)?reverse as user>…</#list>

4.异常解决

4.1、freemarker.core.InvalidReferenceException: The following has evaluated to null or missing:-

处理传的值为空的问题
原因：可能对象userInfo为空，也可能是planName为空
一、${Bank_Name!""}
user或者name为null，都显示为空。判断为空
如果为空，就以默认值（“!”后的字符）显示。

4.2、freemarker.core._TemplateModelException: Can't convert the date-like value to string because it isn't known if it's a date (no time part), time or date-time value.

原因：时间为string类型

解决：

public static String getEnglishTime(Date date, String format) { return new SimpleDateFormat(format, Locale.ENGLISH).format(date); }

例子：版本2.3.26

@ApiModel("html转pdf请求体")
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Html2PdfReq implements Serializable {

    @ApiModelProperty("业务数据")
    @NotNull(message = "data不能为空")
    private Object data;

    @ApiModelProperty("html模板链接")
    private String templateUrl;

    @ApiModelProperty("文件名称")
    @NotBlank(message = "fileName不能为空")
    private String fileName;

    @ApiModelProperty("html模板代码")
    private String htmlStr;

}

/**
 * html转pdf
 *
 * @param html2PdfReq
 * @return
 * @throws Exception
 */
@Override
public String html2Pdf(Html2PdfReq html2PdfReq) throws Exception {
    if (StringUtils.isBlank(html2PdfReq.getTemplateUrl())) {
        throw new CogoBusinessException(CogoExceptionEnum.NULL_ERROR.getCode(), CogoExceptionEnum.NULL_ERROR.getMessage());
    }
    String templateHtml = fillInTemplate(html2PdfReq.getTemplateUrl(), html2PdfReq.getData());
    return makePdfUploadOss(templateHtml, html2PdfReq.getFileName());
}

/**
 * 填充HTML模板  版本
 * * @param templateStr 模板代码
 * @param data        模板填充数据
 * @return 填充后的HTML文件
 * @throws Exception 异常
 */
public String fillInTemplateStr(String templateStr, Object data) throws Exception {
    try {
        // 将参数填入模板
        StringTemplateLoader stringLoader = new StringTemplateLoader();
        stringLoader.putTemplate("view", templateStr);
        Configuration configuration = new Configuration(Configuration.VERSION_2_3_26);
        configuration.setTemplateLoader(stringLoader);
        return FreeMarkerTemplateUtils.processTemplateIntoString(configuration.getTemplate("view"), data);
    } catch (Exception e) {
        log.error("HTML模板填充异常 data:{}", JsonUtil.objectToJson(data), e);
        throw e;
    }
}

/**
 * 制作pdf
 *
 * @param templateHtml
 * @param fileName
 * @return
 * @throws Exception
 */
private String makePdfUploadOss(String templateHtml, String fileName) throws Exception {
    initFont();
    ByteArrayOutputStream bos = new ByteArrayOutputStream();
    try {
        File font1 = new File(vaProveTemplateConfig.getFolder() + "Arial.ttf");
        File font2 = new File(vaProveTemplateConfig.getFolder() + "Calibri.ttf");
        File font3 = new File(vaProveTemplateConfig.getFolder() + "Microsoft YaHei.ttf");
        ITextRenderer render = new ITextRenderer();
        ITextFontResolver fontResolver = render.getFontResolver();
        fontResolver.addFont(font1.getAbsolutePath(), BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);
        fontResolver.addFont(font2.getAbsolutePath(), BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);
        fontResolver.addFont(font3.getAbsolutePath(), BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);
        render.setDocumentFromString(templateHtml);
        render.layout();
        render.createPDF(bos);
        render.finishPDF();
    } catch (Exception e) {
        log.error("html转pdf，转换异常 html2PdfReq", e);
        throw e;
    } finally {
        bos.close();
    }

    OssResMessage ossResMessage = ossSdkUtil.uploadFile(new ByteArrayInputStream(bos.toByteArray()), fileName);
    log.info("文件{}，上传OSS完成，返回信息:{}。", fileName, JsonUtil.objectToJson(ossResMessage));
    if (!ossResMessage.getSuccess()) {
        log.error("文件{}，上传OSS失败。原因:{}", fileName, ossResMessage.getMessage());
        throw new CogoBusinessException(CogoExceptionEnum.FILE_UPLOAD_FAIL.getCode(), CogoExceptionEnum.FILE_UPLOAD_FAIL.getMessage());
    }
    return ossResMessage.getPublicCdnHttp();
}

html模板列子

Transaction Record