Windows环境CF2021企业版：配置PDF Service Manager及cfhtmltopdf使用求助

针对Windows环境下CF2021企业版使用<cfhtmltopdf>时的连接拒绝问题，按以下步骤排查修复：

1. 确认PDF服务状态 #

打开Windows服务列表（运行services.msc），找到ColdFusion PDF Service，检查是否处于"正在运行"状态：

• 未启动则手动尝试启动；启动失败时，去事件查看器的「Windows日志→应用程序」中查找服务启动失败的具体原因（比如端口被占用、依赖缺失）。

2. 同步CFAdmin与PDF服务的端口配置 #

CFAdmin里的端口必须和PDF服务实际监听端口完全一致：

• 打开CF安装目录下的\cfusion\addons\pdfg\conf\jetty.xml，找到端口配置段，确认端口号（比如你修改后的8998）：

  <Call name="addConnector">
    <Arg>
      <New class="org.eclipse.jetty.server.ServerConnector">
        <Arg name="server"><Ref refid="Server"/></Arg>
        <Set name="host"><Property name="jetty.host" default="127.0.0.1"/></Set>
        <Set name="port"><Property name="jetty.port" default="8993"/></Set>
      </New>
    </Arg>
  </Call>
  

• 修改后保存文件，重启ColdFusion PDF Service，再回到CFAdmin的PDF Manager页面更新端口并重新验证。

3. 统一服务运行权限 #

确保ColdFusion主服务和ColdFusion PDF Service使用相同的运行账户（推荐用Local System账户，或具备管理员权限的域账户）：

• 右键服务→属性→登录选项卡，核对用户设置，避免权限隔离导致的连接失败。

4. 排查PDF服务专属日志 #

查看PDF服务的本地日志定位问题：

• 日志路径：\cfusion\addons\pdfg\logs，重点检查stderr.log和stdout.log，里面会记录服务启动时的错误（比如Java路径错误、证书无效、文件夹权限不足）。

5. 验证PDF服务可访问性 #

直接用浏览器访问http://127.0.0.1:[端口]/PDFgServlet/verify：

• 返回OK说明PDF服务本身正常，问题出在CFAdmin配置或CF主服务权限；无法访问则说明PDF服务未正确启动或端口配置错误。

6. 重装PDF Add-On Service #

若以上步骤无效，尝试彻底重装组件：

1. 停止ColdFusion主服务和PDF服务；
2. 从控制面板卸载ColdFusion Add-On Service；
3. 下载对应CF2021版本的Add-On安装包，以管理员身份运行安装；
4. 安装完成后依次启动PDF服务和ColdFusion主服务，再去CFAdmin验证连接。

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