pretix项目在PostgreSQL 16环境下的密码哈希问题解决方案

问题背景

pretix是一个开源的活动票务系统，近期有用户在全新安装时遇到了系统无法正常启动的问题。该问题出现在使用PostgreSQL 16作为数据库的环境中，具体表现为在执行数据库迁移时密码哈希过程失败。

问题现象

当用户尝试在PostgreSQL 16环境下进行全新安装时，系统在执行数据库迁移过程中会抛出"HashingError: Threading failure"错误。这一错误发生在pretix尝试为默认管理员账户设置密码的阶段，具体是在使用Argon2密码哈希算法时出现的线程问题。

根本原因分析

经过深入调查，发现问题的根源并非直接与PostgreSQL 16相关，而是与Argon2密码哈希算法的实现有关。Argon2算法默认配置需要8个CPU线程来执行密码哈希操作，而许多现代虚拟化环境（如VPS）通常只提供4个vCPU核心。这种资源不匹配导致了线程创建失败，进而使整个安装过程中断。

解决方案

针对这一问题，我们提供了两种可行的解决方案：

方案一：调整系统资源分配

如果环境允许，可以增加虚拟机的CPU核心数至8个或更多。这将满足Argon2算法的默认线程需求，使安装过程能够顺利完成。

方案二：修改密码哈希算法配置

对于资源受限的环境，更实用的解决方案是修改pretix的密码哈希算法配置，改用对资源要求较低的算法。具体步骤如下：

1. 修改pretix的配置文件production_settings.py，调整PASSWORD_HASHERS列表的顺序，将BCryptSHA256PasswordHasher放在首位：

PASSWORD_HASHERS = [
    "django.contrib.auth.hashers.BCryptSHA256PasswordHasher",
    "django.contrib.auth.hashers.ScryptPasswordHasher",
    "django.contrib.auth.hashers.PBKDF2PasswordHasher",
    "django.contrib.auth.hashers.PBKDF2SHA1PasswordHasher",
    "django.contrib.auth.hashers.Argon2PasswordHasher",
]

2. 在Docker环境中，可以通过自定义Dockerfile来确保配置生效：

FROM pretix/standalone:stable

USER root

COPY files/config/production_settings.py /pretix/src/production_settings.py

RUN pip uninstall -y argon2-cffi && \
    pip install django[bcrypt]

USER pretixuser

注意事项

1. 修改密码哈希算法后，所有用户密码将在下次登录时自动重新哈希
2. 历史密码记录(HistoricPassword)不会自动更新，在严重安全问题时可能需要手动处理
3. BCrypt算法虽然对资源要求较低，但安全性仍然有保障，是Django框架的推荐选项之一

结论

在资源受限的环境中部署pretix时，合理配置密码哈希算法是确保系统顺利运行的关键。通过调整PASSWORD_HASHERS配置，可以有效解决因线程资源不足导致的安装失败问题，同时保持系统的安全性。这一解决方案不仅适用于PostgreSQL 16环境，对于其他数据库版本和部署环境也具有参考价值。