本文旨在帮助开发者解决 Drupal 9 项目在使用 SQLite 数据库时遇到的 "attempt to write a readonly database" 错误。该错误通常是由于文件/文件夹权限或 SELinux 强制执行策略引起的。本文将详细介绍如何诊断和解决此类问题，确保 Drupal 9 项目能够正常运行。
在使用 SQLite 作为 Drupal 9 项目的数据库时，可能会遇到 "PDOException: SQLSTATE[HY000]: General error: 8 attempt to write a readonly database" 错误。这通常意味着 Drupal 尝试写入数据库，但由于权限或安全策略的限制，无法完成写入操作。以下是解决此问题的步骤：
1. 检查文件和文件夹权限
首先，确保 Drupal 可以写入 SQLite 数据库文件及其所在的目录。
定位数据库文件： Drupal 的 settings.php 文件中定义了数据库连接信息，找到 SQLite 数据库文件的路径。通常位于 sites/default/files/.ht.sqlite 或类似位置。
-
检查目录权限： 确保数据库文件所在的目录具有正确的写入权限。使用以下命令更改目录权限：
chmod 777 /var/www/virtualhosts/protech/protech/web/sites/default/files
请将 /var/www/virtualhosts/protech/protech/web/sites/default/files 替换为你的实际目录路径。chmod 777 赋予了所有用户读、写和执行权限。注意： 在生产环境中，777 权限可能过于宽松，建议根据实际需求进行更精细的权限控制，例如使用 775 并确保 Web 服务器用户拥有该目录的所属组。
-
检查文件权限： 确保数据库文件本身具有写入权限。使用以下命令更改文件权限：
chmod 666 /var/www/virtualhosts/protech/protech/web/sites/default/files/.ht.sqlite
请将 /var/www/virtualhosts/protech/protech/web/sites/default/files/.ht.sqlite 替换为你的实际数据库文件路径。chmod 666 赋予了所有用户读写权限。同样，在生产环境中，建议进行更精细的权限控制。
2. 检查 SELinux 设置
SELinux (Security-Enhanced Linux) 是一种 Linux 内核安全模块，用于增强系统的安全性。如果 SELinux 处于启用状态，并且配置不当，可能会阻止 Drupal 写入 SQLite 数据库。
-
检查 SELinux 状态： 使用以下命令检查 SELinux 的状态：
sestatus
如果输出显示 SELinux status: enabled，则表示 SELinux 处于启用状态。
查看 SELinux 日志： SELinux 阻止操作时，会在日志中记录相关信息。查看 /var/log/audit/audit.log 文件，查找与 Drupal 和 SQLite 相关的错误信息。
-
临时禁用 SELinux（不推荐）： 作为测试，可以临时禁用 SELinux。警告： 这会降低系统的安全性，不建议在生产环境中使用。
setenforce 0
这将 SELinux 设置为 Permissive 模式，允许所有操作但会记录日志。如果禁用 SELinux 后问题解决，则说明 SELinux 是导致问题的根源。
-
配置 SELinux 规则： 正确的做法是配置 SELinux 规则，允许 Drupal 写入 SQLite 数据库。可以使用 chcon 命令更改文件的 SELinux 上下文：
chcon -t httpd_sys_rw_content_t /var/www/virtualhosts/protech/protech/web/sites/default/files/.ht.sqlite chcon -t httpd_sys_rw_content_t /var/www/virtualhosts/protech/protech/web/sites/default/files
这些命令将数据库文件和目录的 SELinux 上下文更改为 httpd_sys_rw_content_t，允许 Web 服务器进程 (httpd) 对其进行读写。
注意： 上述方法在系统重启后可能会失效。要使更改永久生效，可以使用 semanage fcontext 命令：
semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/virtualhosts/protech/protech/web/sites/default/files/.ht.sqlite" semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/virtualhosts/protech/protech/web/sites/default/files" restorecon -v /var/www/virtualhosts/protech/protech/web/sites/default/files/.ht.sqlite restorecon -v /var/www/virtualhosts/protech/protech/web/sites/default/files
这些命令定义了文件上下文规则，并使用 restorecon 命令将规则应用到文件和目录。
3. 检查 PHP 配置
确保 PHP 已经正确安装了 SQLite 扩展。
检查 PHP 扩展： 创建一个包含 phpinfo(); 的 PHP 文件，并通过 Web 浏览器访问该文件。查找 "SQLite3" 或 "PDO_SQLITE" 扩展，确保它们已启用。
-
安装/启用扩展： 如果缺少 SQLite 扩展，请使用包管理器安装：
yum install php-sqlite3 # CentOS/RHEL apt-get install php-sqlite3 # Debian/Ubuntu
安装完成后，重启 Web 服务器。
4. 总结与注意事项
解决 "attempt to write a readonly database" 错误通常涉及检查文件/文件夹权限和 SELinux 设置。
- 权限： 确保 Web 服务器用户拥有对 SQLite 数据库文件及其所在目录的写入权限。
- SELinux： 如果 SELinux 处于启用状态，配置正确的规则，允许 Web 服务器进程访问 SQLite 数据库。
- PHP 扩展： 确保 PHP 已经安装并启用了 SQLite 扩展。
- 安全性： 在生产环境中，谨慎使用 chmod 777，并尽可能使用更精细的权限控制和 SELinux 规则。
通过仔细检查这些方面，可以有效地解决 Drupal 9 项目在使用 SQLite 数据库时遇到的权限问题。
