解决 Drupal 9 SQLite 数据库 "attempt to write a readonly database" 错误-php教程-PHP中文网

解决 Drupal 9 SQLite 数据库 "attempt to write a readonly database" 错误

心靈之曲

发布： 2025-07-08 17:08:02

原创

876人浏览过

解决 drupal 9 sqlite 数据库

本文旨在帮助开发者解决 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 服务器。