部署到Nginx后jsPDF.text传align参数报Invalid arguments错误如何解决

触发原因 #

• 版本不一致：本地开发环境安装的是支持options对象参数的2.x以上版本jsPDF，但生产打包时依赖锁文件异常，拉取了不支持第四个参数为对象的低版本jsPDF，低版本仅支持text(text, x, y, align, angle)的参数顺序，传入对象会被判定为非法参数。
• 静态资源缓存：Nginx部署后没有清理旧的静态资源缓存，浏览器加载的还是旧版jsPDF代码，不支持新语法。
• 打包优化异常：生产模式下打包工具对代码做压缩优化时，错误处理了options对象的结构，导致jsPDF无法识别传入的参数格式。

修复方案 #

• 先确认版本一致性：在本地和生产环境都打印pdf.version核对版本，如果生产版本低于2.3.0，直接将package.json中jsPDF的依赖改为固定版本号，删除锁文件和node_modules后重新安装依赖打包，避免自动拉取低版本。
• 换用全版本兼容写法：直接将报错行的代码替换为旧版兼容语法，无需包成对象，高低版本都可正常运行：

pdf.text('INVOICE', 550, col2y, 'right');

• 清理Nginx缓存：给静态资源配置文件名哈希后缀，或者调整Nginx配置取消对js/css文件的强制缓存，部署后强制刷新浏览器再测试。
• 调整打包配置：如果使用vite，将jsPDF加入optimizeDeps.include配置项避免tree-shaking误删逻辑；如果使用webpack，不要将jsPDF配置为外部CDN资源，除非CDN版本和本地开发版本完全一致。

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