jquick-pdf 生成企业风险雷达评估 PDF:六维雷达图双系列对比的七个坑
摘要(meta description):金融风控场景的企业六维风险雷达评估,本期与上期评分双系列对比,jquick-pdf 4.7.0+(Apache-2.0 协议)一个 Demo 就够。但雷达图的指标轴、系列顺序、tooltip、模板样式键处处有暗坑,本文按现象→原因→修复代码的格式拆七个我实际踩过的坑,全部对着源码验证,附完整 Java 源码与模板。
标签:jquick-pdf、Java PDF、报表开发、风险雷达
官网示例:
- FORMULAS 示例页:https://www.jquick.org/jquick-pdf/demo/23_risk_radar/
- github 地址:https://github.com/paohaijiao/jquick-pdf
真实渲染效果预览
以下为上述代码 + 模板真实运行生成的 PDF 首屏预览(由 jquick-pdf 渲染输出,非示意图):

七个坑,一个一个过
企业客户风险等级评估要六个维度——偿债能力、盈利能力、经营稳定性、行业景气度、担保充足度、历史履约,各打一个 0 到 100 的分,还得和上期比。雷达图天生干这个的。Demo JQuickBiz23RiskRadarTest 是我跑通的第一版,但从编译通过到 PDF 长得像样,中间踩了七个坑,按踩中顺序列在这儿。输出路径 D:\test\biz\23_risk_radar.pdf,模板 report/biz/23_risk_radar.txt,主题紫色 #6A1B9A。(效果预览图 alt:jquick-pdf 企业风险雷达评估 PDF,紫色主题,六维双系列雷达图居中,四张评分指标卡与六维明细表铺底)
坑一:指标轴漏配 max,六个维度的分母悬空
JRadar radar = new JRadar();
radar.indicator(
new JRadar.Indicator().name("偿债能力").max(100),
new JRadar.Indicator().name("盈利能力").max(100),
new JRadar.Indicator().name("经营稳定性").max(100),
new JRadar.Indicator().name("行业景气度").max(100),
new JRadar.Indicator().name("担保充足度").max(100),
new JRadar.Indicator().name("历史履约").max(100)
);
option.radar(radar);
每个 JRadar.Indicator 都是 name 加 max 成对出现的,六个维度一个一个 new,不能图省事传一组名字了事。max(100) 是刻度的分母,Demo 里六项数据最高 93 分、最低 72 分,全在 100 以内,刻度取 100 视觉上才不虚标。搭完 radar 别忘了 option.radar(radar) 这行,它是雷达坐标系挂到 JOption 的专属入口,漏了这一行 option 里只有系列没有坐标系,图出不来。
坑二:双系列顺序写反,图和表对不上账
JRadarSeries current = new JRadarSeries();
current.name("本期评分").type(JSeriesType.radar).data(86, 78, 88, 72, 90, 93);
JRadarSeries last = new JRadarSeries();
last.name("上期评分").type(JSeriesType.radar).data(80, 83, 82, 77, 86, 89);
option.series(current, last);
数据数组的顺序就是 radar.indicator() 里维度的顺序:本期 86 对应偿债能力、78 对应盈利能力,一路对到历史履约 93。我改过一次维度顺序——把行业景气度挪到第二位——结果忘了同步调 data 数组,雷达图上"行业景气度 78 分"其实画的是盈利能力的数,而模板里"二、六维评分明细"那张表是按维度名排的行,图和表当场对不上账。维度顺序、data 数组顺序、明细表行序,三处是同一条隐含契约,改任何一处都要过一遍另外两处。option.series(current, last) 先本期后上期,这个顺序也和明细表"本期评分、上期评分"的列序一致。
坑三:tooltip 不配 trigger,明细只出个名字
option.tooltip().trigger(JTrigger.item);
一行的事,但不写的话悬停明细缺数值。JTrigger.item 表示按数据项触发,雷达图每个顶点的数值都属于 item 级。这行放在 option 组装的最前面,和标题一起构成 option 的基础配置:
option.title().text("企业客户风险等级多维评估").subtext("各维度评分(满分100,分值越高越稳健)");
标题的链式写法和有些 Demo 里 option.title("主标题", "副标题") 的两参写法是两条路,效果一样,别混着用——同一份 option 里先链式再两参,后者会覆盖前者,我这么干过一次,subtext 被冲掉。副标题那句"分值越高越稳健"不是废话,是给读图人的方向说明:雷达图形状外扩代表分高,评审第一次看图时这句话省掉了口头解释。图表按 700pt × 380pt 的横版比例出图,模板里 svg 只写 width:700pt 不写高度,宽度被收窄时按比例缩,这个约定在这套 Demo 里是通用的。
坑四:样式键驼峰与连字符混写,同款样式两种拼法
这份模板是我见过的第一份两种拼法并存的:抬头卡片里写 borderLeft:1px solid #8E5BA6、justifyContent:space-between,到下面结论区又写成 border-left:3px solid #6A1B9A、list-style-type:none、padding-left:0。两种拼法渲染都正常,说明模板引擎对连字符和驼峰都认。但坑在维护:我后来给明细表加一列样式,从连字符段复制了一份粘到驼峰段,改键名的时候改错方向,样式没生效还查了半天。定一条团队规矩吧——同一份模板从头到尾统一一种拼法,我的选择是驼峰,因为里头 fontSize、bold 这类本来就是驼峰风格。
坑五:四张指标卡不等高,底边参差
抬头下面四张 KPI 卡:本期综合评分 84.5、较上期提升 +1.7、最高维度历史履约 93、最低维度行业景气度 72。
<div style="width:132px; minHeight:54px; background:#F3EAF7; borderRadius:4px; padding:8px; verticalAlignment:middle">
<p style="color:#6A1B9A; fontSize:16; bold:true; textAlignment:center; marginBottom:2px">'84.5'</p>
<p style="color:#5A6B7C; fontSize:9; textAlignment:center">'本期综合评分'</p>
</div>
第一版我把 minHeight:54px 删了,觉得卡片内容一样多高度自然相等。实际不等:数字位数不同、说明文字两行的"最低维度:行业景气度"和一行的"本期综合评分"占高不一样,四张卡底边参差。修复就是把 minHeight 加回来,再配 verticalAlignment:middle 让内容在卡内垂直居中。四个 132px 定宽的卡靠外层 display:flex; justifyContent:space-between 摊开,间距自动均分。算一笔账:四卡共 528px,版心 560px 上下,剩 30 多像素被 space-between 切成三段,间距均衡但卡片几乎顶满,再多加一张卡就得缩宽度。数字颜色也有讲究:84.5 用主题紫,两个"好"数(+1.7、93)用 #1B5E20 绿,72 用 #BF360C 橙红示警,一眼扫过去好坏分明。四张卡整体套了 keepTogether:true,分页时四张卡不拆散。
坑六:明细表斑马纹用了主题色的极浅变体
<td style="padding:5px; backgroundColor:#F3EAF7; border:1px solid #DCE3EC">'盈利能力'</td>
表头 #6A1B9A 实底白字,五列是评估维度、本期评分、上期评分、环比变动、状态评价,隔行垫 #F3EAF7——这是主题紫的极浅变体,不是通用灰。我踩的坑是想当然用了白灰斑马纹(#f5f5f5 之类),整页紫色系里突然插进一段中性灰,割裂感明显。斑马纹从主题色里取最浅一档,模板里抬头右侧信息卡的底色同样是 #F3EAF7,颜色体系就收敛在一支色相里。整行染色时要注意斑马纹是铺满六个格子的,我漏过数据格只染了维度名,一行里半截紫半截白,重跑才看出来。环比变动列的数值我没加色,状态评价列里"改善""优"留给正文字重去表达,避免一页里颜色超过三个语义。
坑七:结论区丢了左肩竖线,四条建议散成一段墙
<li style="marginBottom:6px; padding:8px; backgroundColor:#F3EAF7; border-left:3px solid #6A1B9A">
'整体评级上调:本期六维综合评分84.5分,上期82.8分,环比提升1.7分,风险等级由B+上调至A(低风险)。'
</li>
抬头卡片是紫底白字的双栏:左边 300px 装标题和副标题,右边 240px 右对齐的评估周期、编制单位、报送对象三行 9 号字,两栏之间隔一道 borderLeft:1px solid #8E5BA6——比底色亮一档的紫当分隔线,不抢标题的戏。我最早把右边三行塞进抬头外另起一块,页首变成两截,评审意见是"信息卡和标题是一个整体",挪回色块里用细线隔开才对。
四条结论——评级上调、优势维度、短板预警、授信建议——每条都是一个浅紫底的小色块。我最开始删了 border-left:3px solid #6A1B9A,四块浅底贴在一起糊成一片,分不清哪条到哪条结束。左肩这根 3px 紫线是每块卡片的轮廓,视觉上把四条建议切成四个独立单元,授信建议那条(允许上浮 10%、行业景气度连续两期低于 70 分触发额度重检)是评审最关注的内容,也靠这根线在版面上站得住。图表下面还有一行斜体的 9 号图注,"本期 vs 上期;数据来源:信用评估系统",别看字小,评审问数据出处时它就是答案。加回左肩线重跑,分块感立刻回来。页尾单独一行 8 号斜体居中:模型版本六维风险模型 V3.2、生成时间、密级"秘密"——密级和来源写在一行,是这份模板比其他 Demo 细的地方。
复现清单
- 依赖
io.github.paohaijiao:jquick-pdfx:4.7.0+(Apache-2.0 协议); JRadar.Indicator逐个配 name 加 max(100),option.radar()挂载坐标系;- 两个
JRadarSeries按 indicator 顺序喂 data,option.series(current, last)双系列; option.tooltip().trigger(JTrigger.item)配触发方式;JPdfConfig开setFlexLayout(true),模板 flex 布局才生效;- 四张 KPI 卡
minHeight:54px加verticalAlignment:middle保等高; - 明细表斑马纹取主题色最浅变体 #F3EAF7,结论条左肩 3px 竖线;
- 输出验证
D:\test\biz\23_risk_radar.pdf。
完整源码附录
/*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* Copyright (c) [2025-2099] Martin (goudingcheng@gmail.com)
*/
package com.github.paohaijiao.biz.chart;
import com.github.paohaijiao.JOption;
import com.github.paohaijiao.JRadar;
import com.github.paohaijiao.code.JSeriesType;
import com.github.paohaijiao.code.JTrigger;
import com.github.paohaijiao.config.JPdfConfig;
import com.github.paohaijiao.demo.constant.JQuickConstant;
import com.github.paohaijiao.enums.JChartType;
import com.github.paohaijiao.executor.JQuickPdfFactory;
import com.github.paohaijiao.factory.JChartRendererFactory;
import com.github.paohaijiao.series.JRadarSeries;
import org.junit.Test;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
/**
* 业务场景 Demo 23:企业客户风险等级雷达评估(金融/信用平台)
*
* <p>业务场景:金融/信用平台对某企业客户做风险等级多维评估,从偿债能力、盈利能力、
* 经营稳定性、行业景气度、担保充足度、历史履约六个维度打分(满分100),并与上期评分对比。</p>
* <p>实际图表类型:{@link JChartType#RADAR} 雷达图(双系列:本期评分 / 上期评分)。</p>
*
* <p>模板:{@code report/biz/23_risk_radar.txt};图表以 SVG 文本形式绑定到模板的
* {@code ${svg}} 占位符,输出到 {@code D:\test\biz\23_risk_radar.pdf}。</p>
*
* <p>图表尺寸说明:图表按 700pt × 380pt(宽 × 高)的横版比例设计;模板中 {@code <svg>}
* 只声明宽度、不声明高度,因此宽度被页面自动收窄时高度会按原比例同步缩放,不会纵向拉伸变形。</p>
*
* @author Martin
* @version 1.0.0
*/
public class JQuickBiz23RiskRadarTest {
public static final String path = JQuickConstant.path;
@Test
public void biz23RiskRadar() throws IOException {
JOption option = new JOption();
option.title().text("企业客户风险等级多维评估").subtext("各维度评分(满分100,分值越高越稳健)");
option.tooltip().trigger(JTrigger.item);
JRadar radar = new JRadar();
radar.indicator(
new JRadar.Indicator().name("偿债能力").max(100),
new JRadar.Indicator().name("盈利能力").max(100),
new JRadar.Indicator().name("经营稳定性").max(100),
new JRadar.Indicator().name("行业景气度").max(100),
new JRadar.Indicator().name("担保充足度").max(100),
new JRadar.Indicator().name("历史履约").max(100)
);
option.radar(radar);
// 双系列对比:本期评分与上期评分
JRadarSeries current = new JRadarSeries();
current.name("本期评分").type(JSeriesType.radar).data(86, 78, 88, 72, 90, 93);
JRadarSeries last = new JRadarSeries();
last.name("上期评分").type(JSeriesType.radar).data(80, 83, 82, 77, 86, 89);
option.series(current, last);
String svg = JChartRendererFactory.renderChart(JChartType.RADAR, option);
File dir = new File(path + "biz");
if (!dir.exists()) {
dir.mkdirs();
}
FileOutputStream fileOutputStream = new FileOutputStream(path + "biz/23_risk_radar.pdf");
JPdfConfig config = new JPdfConfig();
// 开启 flex 行布局,使模板中的 display:flex 生效(图表居中)
config.getLayoutConfig().setFlexLayout(true);
JQuickPdfFactory factory = new JQuickPdfFactory(config);
factory.bind("svg", svg);
byte[] bytes = factory.executeResource("report/biz/23_risk_radar.txt");
fileOutputStream.write(bytes);
fileOutputStream.close();
}
}
<pdf>
<body>
<div style="background:#6A1B9A; padding:14px; borderRadius:4px; marginBottom:12px; keepTogether:true">
<div style="display:flex; justifyContent:space-between">
<div style="width:300px">
<h1 style="color:white; fontSize:18; bold:true; marginBottom:4px">'企业客户风险等级多维评估'</h1>
<p style="color:#E6D6EF; fontSize:9">'六维风险模型评分(满分100,分值越高越稳健)'</p>
</div>
<div style="width:240px; textAlignment:right; borderLeft:1px solid #8E5BA6; paddingLeft:10px">
<p style="color:white; fontSize:9">'评估周期:2024年第四季度'</p>
<p style="color:#E6D6EF; fontSize:9">'编制单位:风险管理部信用评估岗'</p>
<p style="color:#E6D6EF; fontSize:9">'报送对象:信贷审查委员会'</p>
</div>
</div>
</div>
<div style="display:flex; justifyContent:space-between; marginBottom:12px; keepTogether:true">
<div style="width:132px; minHeight:54px; background:#F3EAF7; borderRadius:4px; padding:8px; verticalAlignment:middle">
<p style="color:#6A1B9A; fontSize:16; bold:true; textAlignment:center; marginBottom:2px">'84.5'</p>
<p style="color:#5A6B7C; fontSize:9; textAlignment:center">'本期综合评分'</p>
</div>
<div style="width:132px; minHeight:54px; background:#F3EAF7; borderRadius:4px; padding:8px; verticalAlignment:middle">
<p style="color:#1B5E20; fontSize:16; bold:true; textAlignment:center; marginBottom:2px">'+1.7'</p>
<p style="color:#5A6B7C; fontSize:9; textAlignment:center">'较上期提升'</p>
</div>
<div style="width:132px; minHeight:54px; background:#F3EAF7; borderRadius:4px; padding:8px; verticalAlignment:middle">
<p style="color:#1B5E20; fontSize:16; bold:true; textAlignment:center; marginBottom:2px">'93'</p>
<p style="color:#5A6B7C; fontSize:9; textAlignment:center">'最高维度:历史履约'</p>
</div>
<div style="width:132px; minHeight:54px; background:#F3EAF7; borderRadius:4px; padding:8px; verticalAlignment:middle">
<p style="color:#BF360C; fontSize:16; bold:true; textAlignment:center; marginBottom:2px">'72'</p>
<p style="color:#5A6B7C; fontSize:9; textAlignment:center">'最低维度:行业景气度'</p>
</div>
</div>
<div style="marginBottom:10px">
<h2 style="color:#6A1B9A; fontSize:13; bold:true; marginBottom:6px">'一、多维风险评分雷达图'</h2>
<div style="display:flex; justifyContent:center">
<svg style="width:700pt">${svg}</svg>
</div>
<p style="fontSize:9; color:#6c757d; italic:true; marginTop:6px">'图 1 企业客户六维风险评分(本期 vs 上期;数据来源:信用评估系统)'</p>
</div>
<div style="marginBottom:10px">
<h2 style="color:#6A1B9A; fontSize:13; bold:true; marginBottom:6px">'二、六维评分明细'</h2>
<table style="width:540px; fontSize:10">
<tr>
<th style="backgroundColor:#6A1B9A; color:white; padding:6px; textAlign:center; border:1px solid #DCE3EC">'评估维度'</th>
<th style="backgroundColor:#6A1B9A; color:white; padding:6px; textAlign:center; border:1px solid #DCE3EC">'本期评分'</th>
<th style="backgroundColor:#6A1B9A; color:white; padding:6px; textAlign:center; border:1px solid #DCE3EC">'上期评分'</th>
<th style="backgroundColor:#6A1B9A; color:white; padding:6px; textAlign:center; border:1px solid #DCE3EC">'环比变动'</th>
<th style="backgroundColor:#6A1B9A; color:white; padding:6px; textAlign:center; border:1px solid #DCE3EC">'状态评价'</th>
</tr>
<tr>
<td style="padding:5px; border:1px solid #DCE3EC">'偿债能力'</td>
<td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'86'</td>
<td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'80'</td>
<td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'+6'</td>
<td style="padding:5px; border:1px solid #DCE3EC">'改善'</td>
</tr>
<tr>
<td style="padding:5px; backgroundColor:#F3EAF7; border:1px solid #DCE3EC">'盈利能力'</td>
<td style="padding:5px; textAlign:right; backgroundColor:#F3EAF7; border:1px solid #DCE3EC">'78'</td>
<td style="padding:5px; textAlign:right; backgroundColor:#F3EAF7; border:1px solid #DCE3EC">'83'</td>
<td style="padding:5px; textAlign:right; backgroundColor:#F3EAF7; border:1px solid #DCE3EC">'-5'</td>
<td style="padding:5px; backgroundColor:#F3EAF7; border:1px solid #DCE3EC">'小幅下滑'</td>
</tr>
<tr>
<td style="padding:5px; border:1px solid #DCE3EC">'经营稳定性'</td>
<td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'88'</td>
<td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'82'</td>
<td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'+6'</td>
<td style="padding:5px; border:1px solid #DCE3EC">'改善'</td>
</tr>
<tr>
<td style="padding:5px; backgroundColor:#F3EAF7; border:1px solid #DCE3EC">'行业景气度'</td>
<td style="padding:5px; textAlign:right; backgroundColor:#F3EAF7; border:1px solid #DCE3EC">'72'</td>
<td style="padding:5px; textAlign:right; backgroundColor:#F3EAF7; border:1px solid #DCE3EC">'77'</td>
<td style="padding:5px; textAlign:right; backgroundColor:#F3EAF7; border:1px solid #DCE3EC">'-5'</td>
<td style="padding:5px; backgroundColor:#F3EAF7; border:1px solid #DCE3EC">'持续承压'</td>
</tr>
<tr>
<td style="padding:5px; border:1px solid #DCE3EC">'担保充足度'</td>
<td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'90'</td>
<td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'86'</td>
<td style="padding:5px; textAlign:right; border:1px solid #DCE3EC">'+4'</td>
<td style="padding:5px; border:1px solid #DCE3EC">'优'</td>
</tr>
<tr>
<td style="padding:5px; backgroundColor:#F3EAF7; border:1px solid #DCE3EC">'历史履约'</td>
<td style="padding:5px; textAlign:right; backgroundColor:#F3EAF7; border:1px solid #DCE3EC">'93'</td>
<td style="padding:5px; textAlign:right; backgroundColor:#F3EAF7; border:1px solid #DCE3EC">'89'</td>
<td style="padding:5px; textAlign:right; backgroundColor:#F3EAF7; border:1px solid #DCE3EC">'+4'</td>
<td style="padding:5px; backgroundColor:#F3EAF7; border:1px solid #DCE3EC">'优'</td>
</tr>
</table>
</div>
<div style="marginBottom:10px">
<h2 style="color:#6A1B9A; fontSize:13; bold:true; marginBottom:6px">'三、评估结论与授信建议'</h2>
<list style="list-style-type:none; padding-left:0; fontSize:10">
<li style="marginBottom:6px; padding:8px; backgroundColor:#F3EAF7; border-left:3px solid #6A1B9A">
'整体评级上调:本期六维综合评分84.5分,上期82.8分,环比提升1.7分,风险等级由B+上调至A(低风险)。'
</li>
<li style="marginBottom:6px; padding:8px; backgroundColor:#F3EAF7; border-left:3px solid #6A1B9A">
'优势维度突出:历史履约93分、担保充足度90分、经营稳定性88分稳居优秀区间,履约记录扎实、增信措施充分。'
</li>
<li style="marginBottom:6px; padding:8px; backgroundColor:#F3EAF7; border-left:3px solid #6A1B9A">
'短板维度预警:行业景气度72分、盈利能力78分均环比下降5分,是本期唯一两项走弱的指标,需持续跟踪。'
</li>
<li style="marginBottom:6px; padding:8px; backgroundColor:#F3EAF7; border-left:3px solid #6A1B9A">
'授信建议:维持现有授信额度并允许上浮10%;将行业景气度纳入季度监测,连续两期低于70分即触发额度重检。'
</li>
</list>
</div>
<p style="textAlignment:center; color:#8a939b; fontSize:8; italic:true; marginTop:10px">'数据来源:信用评估系统(六维风险模型 V3.2) | 生成时间:2025年1月6日 | 密级:秘密'</p>
</body>
</pdf>