PDF线性渐变在不同阅读器中显示异常，请求排查问题

问题诊断 #

你的PDF在Chrome正常显示，但Firefox渲染黑块、Acrobat空白，核心原因有两个：内容流操作顺序违反PDF规范，以及不必要使用FunctionType3（拼接函数）导致的解析兼容性问题。

具体错误与修复方案 #

1. 内容流绘图顺序错误 #

PDF的绘图状态（如颜色）需要先设置，再应用到后续的路径上。你的内容流先设置了Pattern颜色，再创建路径，最后填充——严格遵循规范的渲染器（Acrobat、Firefox）会忽略这个错误操作，因为填充时路径还没创建就设置了颜色。

错误代码（对象9的stream）：

/Pattern sc
/P1 scn
30 300 370 450 re
 f

修正后的内容流：

30 300 370 450 re
/Pattern sc
/P1 scn
f

2. 不必要的FunctionType3使用 #

你用了FunctionType3（拼接函数）包裹单个FunctionType2（指数插值函数），虽然PDF规范允许空/Bounds，但部分渲染器对这种冗余结构的解析存在兼容问题。直接用FunctionType2作为Shading的Function更简洁规范。

原Shading的Function部分：

/Function 
    <</FunctionType 3 
    /Domain [0 1 ] 
    /Bounds [] 
    /Encode [1 0 ] 
    /Functions [
        <</FunctionType 2 
        /Domain [0 1 ] 
        /C0 [0 0.733 0 ] 
        /C1 [0 0 0 ] 
        /N 1 
        >> 
    ] 
    >> 

修正后的Function部分（保留原渐变反转效果）：

/Function 
    <</FunctionType 2 
    /Domain [0 1 ] 
    /C0 [0 0 0 ] 
    /C1 [0 0.733 0 ] 
    /N 1 
    >> 

（注：原/Encode [1 0]是反转渐变方向，这里直接交换C0和C1达到相同效果，避免额外的反转参数）

修正后的完整PDF源码 #

%PDF-1.4
1 0 obj 
<</Type /Catalog /Version /1.4 /Pages 2 0 R /Names 5 0 R >>
endobj
2 0 obj 
<</Type /Pages /Kids [8 0 R ] /Count 1 >>
endobj
3 0 obj 
[]
endobj
4 0 obj 
<</Names 3 0 R >>
endobj
5 0 obj 
<</Dests 7 0 R >>
endobj
6 0 obj 
[]
endobj
7 0 obj 
<</Names 6 0 R >>
endobj
8 0 obj 
<</Type /Page /LastModified (D:20240226231224+01'00') /Resources <</Pattern <</P1 10 0 R >> /ProcSet [/PDF ] >> /MediaBox [0 0 595 842 ] 
/Contents [9 0 R ] /Parent 2 0 R >>
endobj
9 0 obj 
<</Length 41 >>
stream
30 300 370 450 re
/Pattern sc
/P1 scn
f

endstream
endobj
10 0 obj 
<</Type /Pattern 
/PatternType 2 
/Shading 
    <</ShadingType 2 
    /ColorSpace /DeviceRGB 
    /Domain [0 1 ] 
    /Coords [30 750 30 300 ] 
    /Function 
        <</FunctionType 2 
        /Domain [0 1 ] 
        /C0 [0 0 0 ] 
        /C1 [0 0.733 0 ] 
        /N 1 
        >> 
    /Extend [true true ] 
    >> 
/Matrix [1 0 0 1 0 0 ] 
>>
endobj
xref
0 11 
0000000000 65535 f 
0000000015 00000 n 
0000000091 00000 n 
0000000149 00000 n 
0000000168 00000 n 
0000000202 00000 n 
0000000236 00000 n 
0000000255 00000 n 
0000000289 00000 n 
0000000479 00000 n 
0000000570 00000 n 
trailer
<</ID [<38363664323065366363363538333838> <39323837366165306561666364386532> ] /Size 11 /Root 1 0 R >>
startxref
917
%%EOF

验证结果 #

修正后的PDF可在Chrome、Firefox、Acrobat Reader中正常显示从黑色到绿色的垂直线性渐变矩形。

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