NetSuite估算表单按钮生成高级PDF报StringIndexOutOfBoundsException错误

我之前在做NetSuite高级PDF模板开发时也碰到过一模一样的报错，结合你的代码和描述，给你几个实用的排查思路：

1. 优先排查PDF模板中的空值字符串操作 #

这个报错的核心是代码尝试访问长度为0的字符串的索引，大概率出在你的Freemarker模板里，而非Suitelet代码本身。哪怕你移除了图片，模板里可能还有这些隐性问题：

• 使用了${record.someField.substring(0, 5)}这类字符串截取逻辑，但someField是空字符串；
• 调用了${record.someField.charAt(0)}但目标字段没有值；
• 拼接字符串时依赖了空字段的某个属性。

快速验证方法：把模板内容大幅简化，只保留最基础的内容（比如只显示单据号和公司名称），如果能正常渲染，再逐步把模板内容加回去，定位到具体出错的代码块。同时，给所有字符串操作加空值判断，比如：

${record.someField?has_content ? record.someField.substring(0,1) : ''}

2. 检查加载的Estimate记录字段是否异常 #

你的Suitelet直接加载了Estimate记录并传给模板，有些字段可能存在空值或者异常值，尤其是自定义字段。可以在createRenderer函数里加日志打印关键字段，确认数据是否正常：

var estimateRec = record.load({
    type: record.Type.ESTIMATE,
    id: recordId,
    isDynamic: false // 明确使用静态模式，避免动态字段访问问题
});
// 打印模板中用到的所有字段
Library.log('Estimate Record Data', {
    internalId: estimateRec.id,
    entityName: estimateRec.getText('entity'),
    total: estimateRec.getValue('total'),
    // 替换成你模板里用到的自定义字段
    custbody_my_custom_field: estimateRec.getValue('custbody_my_custom_field')
});

如果发现某个字段是null或者空字符串，去模板里检查对应该字段的处理逻辑。

3. 验证模板的Freemarker语法正确性 #

NetSuite的PDF模板基于Freemarker，一些隐性的语法错误也会触发这类奇怪的报错：

• 检查是否有未闭合的标签（比如<#if>没有对应</#if>，<#list>没有</#list>）；
• 确认变量引用格式正确，是${record.field}而不是#{record.field}；
• 避免在条件判断中直接使用空字段，比如将<#if record.someField>改成<#if record.someField?has_content>。

4. 确认Suitelet的参数传递有效 #

有时候按钮传递的id参数可能为空或者无效，导致加载了错误的记录。可以在createRenderer开头加参数校验：

recordId = context.request.parameters.id;
if (!recordId || isNaN(parseInt(recordId))) {
    throw new Error('Invalid Estimate ID received: ' + recordId);
}

避免因无效ID加载异常记录导致的后续渲染问题。

5. 尝试清除NetSuite模板缓存 #

NetSuite有时候会缓存旧的模板版本，哪怕你修改了模板，系统还是在用旧的。试试这些操作：

• 重新保存你的PDF模板（CUSTTMPL_125_4099_SB7_165）；
• 切换到其他Sandbox环境测试，或者清除浏览器缓存后重试。

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