Drupal 7下print_pdf模块目录创建失败问题咨询（含S3fs场景）

我之前处理过不少Drupal 7里Print PDF模块的这类报错，不管是用默认的本地文件系统还是搭配S3fs模块，核心都是路径权限或者模块路径映射的问题，下面分两种场景给你具体的解决办法：

1. 基础Drupal 7环境场景 #

报错内容：Failed to create directory "public://print_pdf/print_pdf_tcpdf/cache" for print_pdf_tcpdf

解决步骤：

• 先检查站点public://对应的物理目录（一般是sites/default/files）的权限，确保运行web服务器的用户（比如www-data、apache）对这个目录有读写执行权限。可以用以下命令调整（根据你的服务器用户修改）：

  chown -R www-data:www-data sites/default/files
  chmod -R 755 sites/default/files
  

• 如果权限没问题，手动创建目标目录：在sites/default/files下新建print_pdf/print_pdf_tcpdf/cache完整路径，同样给这个子目录设置好对应权限。
• 最后清除Drupal的所有缓存：可以后台进入配置 -> 性能点击清除缓存，或者用Drush命令：

  drush cache-clear all
  

2. S3fs模块搭配场景 #

当在S3fs设置页面把public://替换为s3fs-public://后，仍然报错：Failed to create directory public://print_pdf/print_pdf_tcpdf/cache for print_pdf_tcpdf

这个场景的问题大多是Print PDF模块没有正确读取系统配置的文件路径，而是硬编码了public://，解决步骤如下：

• 先确认S3fs的配置是否生效：检查S3fs设置页面的公共文件路径映射是否正确，同时确保S3存储桶对应的IAM权限允许创建对象前缀（也就是S3里的“目录”）。
• 尝试修改Print PDF模块的配置：进入后台配置 -> 用户界面 -> Print -> PDF（路径一般是admin/config/user-interface/print/pdf），查看是否有PDF缓存路径的可配置项，手动将路径改为s3fs-public://print_pdf/print_pdf_tcpdf/cache。
• 如果模块没有提供可配置的路径，需要修改模块代码（操作前务必备份文件）：找到print_pdf_tcpdf.module文件，定位到定义缓存路径的代码行，把硬编码的public://print_pdf/print_pdf_tcpdf/cache替换为读取系统变量的写法：

  variable_get('file_public_path', 'public://') . '/print_pdf/print_pdf_tcpdf/cache'
  

• 最后清除Drupal缓存，同时可以登录S3控制台确认对应的前缀是否已生成（S3会在上传文件时自动创建前缀，也可以手动提前创建）。

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