Overleaf LaTeX 编译失败怎么排查CLSI 与 filestore 的端口、默认值和最小验证请求【免费下载链接】overleafA web-based collaborative LaTeX editor项目地址: https://gitcode.com/GitHub_Trending/ov/overleaf自建 Overleaf 的 PDF 编译出问题多数时候不用翻源码只要分清编译与文件服务两层的边界就能定位。本文给出一个最小 Hello World 请求验证链路并列出 CLSI、filestore 里真正影响排障的默认参数覆盖 Overleaf 编译超时、LaTeX PDF 404、请求被拒这几类常见故障。先定位故障层编译没发生、编译被终止、还是文件没取回排障的第一步是把现象归到三类之一编译根本没发生请求还没进入 CLSI 就被挡掉典型是请求体过大被直接拒绝或 3013 端口不通。编译发生但被终止容器超时、并发排队导致产物缺失log 往往中途截断。编译成功但文件拿不回问题在 filestore 侧3009 端口或其存储后端异常表现为 PDF 地址 404。先把现象钉死再去看 CLSI 服务 和 filestore 服务 里对应的配置。CLSI 负责产出 PDFfilestore 负责把文件交出去两个服务的职责一句话区分CLSI 只把 .tex 变成 PDF 和 log不对外提供文件访问filestore 只负责存取文件和签发访问地址不碰编译。请求关系是单向的编译请求打到 CLSI 的 3013 端口CLSI 产出的文件落到 filestore访问地址由 CLSI 默认配置 里的apis.filestore.url拼出默认指向 3009 端口。filestore 自身没有默认值歧义其默认配置 中BACKEND未设置时只要没配 AWS 凭据就自动落回本地磁盘fs。用一次 Hello World 请求确认编译链路最小验证请求只要三个要素编译器名、主文件路径、文件内容。请求打到http://localhost:3013/project/任意id/compile{compile: {options: {compiler: pdflatex}, rootResourcePath: main.tex, resources: [{path: main.tex, content: \\documentclass{article}\n\\begin{document}Hello World\\end{document}}]}}返回里status为success且outputFiles同时给出 PDF 与 log 两个 URL说明编译侧链路通畅此时如果 PDF 仍打不开问题一定落在 filestore 侧。想换引擎把compiler改成xelatex或lualatex即可。把默认值当作旋钮只调影响排障的那几个排障时一次只动一个参数改完立刻用上面的最小请求复验。参数默认值什么时候调整调整后看什么请求体大小上限7MB大工程提交即被拒响应是否还立即被拒转换容器超时60 秒复杂文档编译中途被杀是否跑到正常结束并发编译上限64共享节点排队久队列时长是否下降filestore 存储后端无凭据时落 fsPDF 地址 404对应存储目录或桶可写关停缓冲30 秒滚动重启时请求掉线在途请求是否完整返回按现象反查报错、超时、404 分别落在哪里请求秒拒→ 优先查 7MB 大小上限其次确认 3013 端口可达。log 中途截断且无 PDF→ 编译超时先调请求内的options.timeout再调服务端转换超时默认 60 秒。编译成功、浏览器打不开 PDF→ 先确认 filestore 的 3009 端口存活再核对BACKEND指向的存储本地fs看 uploads 目录S3/GCS 看凭据与桶名。关停瞬间请求失败→ 把 30 秒关停缓冲调大给在途编译留足时间。收尾前可以按三步快速自检最小请求在 3013 端口返回success两个输出 URL 都能下载filestore 端口与存储后端均可写。全通过仍未解决再按上一节的旋钮逐个调整。【免费下载链接】overleafA web-based collaborative LaTeX editor项目地址: https://gitcode.com/GitHub_Trending/ov/overleaf创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考