Ory Kratos数据库只读错误分析与解决方案

在使用Ory Kratos身份认证系统时，开发者在执行make quickstart-dev命令构建开发环境时遇到了数据库只读错误。这个问题主要出现在SQLite数据库的写入操作中，特别是在执行迁移脚本时。

问题现象

当开发者尝试运行Kratos的快速启动开发环境时，系统在应用数据库迁移时抛出错误：

Error: error executing migrations/sql/20231108111100000000_credential_types_passkey.up.sql
attempt to write a readonly database

类似的问题也出现在创建错误容器时：

sqlite create: named insert: attempt to write a readonly database

根本原因分析

这个问题通常由以下几个潜在原因导致：

1. 文件权限问题：SQLite数据库文件可能没有正确的写入权限，导致Docker容器内的进程无法修改数据库文件。

2. 挂载卷配置问题：在Docker环境中，如果数据库文件是通过卷(volume)挂载的，可能存在挂载配置不当导致容器内无法写入。

3. SQLite连接参数：数据库连接字符串可能缺少必要的参数，导致连接以只读模式打开。

4. 文件系统特性：某些文件系统(如macOS的某些配置)可能对Docker容器内的文件操作有特殊限制。

解决方案

1. 检查文件权限

确保SQLite数据库文件及其所在目录具有正确的权限：

chmod 664 kratos.sqlite
chmod 775 $(dirname kratos.sqlite)

2. 调整Docker挂载配置

在docker-compose配置中，确保数据库文件的挂载配置正确：

volumes:
  - ./kratos.sqlite:/var/lib/sqlite/kratos.sqlite

可以考虑使用命名卷代替直接挂载主机文件：

volumes:
  - kratos-data:/var/lib/sqlite

3. 修改SQLite连接字符串

在Kratos配置文件中，确保SQLite连接字符串包含mode=rwc参数：

dsn: sqlite:///var/lib/sqlite/kratos.sqlite?mode=rwc&_fk=true

4. 使用最新版本

正如项目维护者提到的，这个问题在最新版本的Kratos中已经得到修复。建议开发者升级到最新稳定版本。

预防措施

1. 在开发环境中使用PostgreSQL代替SQLite，可以获得更好的稳定性和性能。

2. 为Docker容器明确指定用户ID，确保与主机文件权限匹配。

3. 在CI/CD流程中加入权限检查步骤，提前发现问题。

总结

Ory Kratos的数据库只读错误通常与权限配置相关，特别是在Docker环境中。通过调整文件权限、优化挂载配置或更新连接参数，可以解决大多数此类问题。对于生产环境，建议使用更健壮的数据库系统如PostgreSQL，以避免SQLite在并发写入时的限制。