最常见原因是pytest未在django项目根目录运行，导致无法定位settings模块；应确保在含manage.py的目录下执行pytest，或用--django-settings=mysite.settings显式指定并配合--pythonpath=.。
pytest-django找不到settings.py或加载错误的配置
最常见原因是pytest没定位到Django项目根目录，导致django.setup()失败或读取了错误的settings模块。pytest-django默认在当前工作目录下找manage.py或settings.py，但很多项目把测试放在子目录（如tests/）里运行，此时pytest的cwd不在项目根。
- 确保在Django项目根目录（含
manage.py）下运行pytest，而不是cd tests && pytest - 若必须从子目录运行，用
--django-settings=mysite.settings显式指定模块路径，并加--pythonpath=.让Python能导入该模块 - 检查
pytest.ini或pyproject.toml中是否误写了django_settings值，比如漏掉包名前缀（写成settings而非mysite.settings） - 验证Django能否手动加载：在Python shell中执行
import mysite.settings; from django.conf import settings; settings.configure(default_settings=mysite.settings)，不报错才算配置可被识别
DatabaseError: connection to server at "localhost" (127.0.0.1), port 5432 failed这类连接拒绝错误
这不是pytest-django的问题，而是Django测试数据库没按预期启动——它本不该连真实PostgreSQL/MySQL实例，而应使用内存SQLite或自动创建的临时数据库。
python-script-generator
下载
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
- 确认
settings.py中DATABASES配置在测试环境下是否被覆盖：pytest-django默认用sqlite3内存数据库，但如果你在settings.py里硬编码了HOST='localhost'且没做环境判断，Django会试图连真实DB - 检查是否误启用了
--reuse-db但没先运行pytest --create-db初始化，导致复用一个损坏或权限不足的旧库 - 如果坚持用PostgreSQL测试，需确保
TEST字典设置了'NAME': 'test_yourdb'，且PostgreSQL用户对test_*库有CREATE权限；更稳妥的做法是改用sqlite3并设'NAME': ':memory:' - 注意
DEBUG=True时某些中间件或信号可能触发非测试DB查询，导致连接失败；可在测试配置中关闭无关组件
测试函数里手动调用django.db.connection.close()后数据库操作失效
pytest-django会在每个测试前后自动管理数据库连接生命周期。手动关闭连接会破坏这个机制，导致后续models.save()或QuerySet执行时报OperationalError: no such table或连接已关闭。
- 删除所有测试代码中对
connection.close()、connection.ensure_connection()的显式调用 - 避免在
setUp()或fixture里执行from django.db import connection; connection.close() - 如果需要重置连接状态（例如模拟连接中断），用
django.test.TransactionTestCase配合reset_sequences=True，而不是手动关连接 - 检查第三方库（如
django-redis或自定义中间件）是否在测试中意外触发了DB连接清理逻辑
使用pytest.mark.django_db但依然提示Database access not allowed
这个错误说明pytest-django的数据库fixture没生效，通常因为标记位置不对或被其他fixture干扰。
-
@pytest.mark.django_db必须直接修饰测试函数或类，不能只放在内部函数或嵌套作用域里 - 如果用了自定义fixture（如
@pytest.fixture返回model实例），该fixture本身也需加@pytest.mark.django_db，否则调用它的测试函数即使标了也不会激活DB - 检查是否在
conftest.py里覆盖了django_db_setup或django_db_blockerfixture，错误实现会导致全局禁用DB访问 - 确认没在
pytest.ini中设置django_db_enabled = false或通过命令行传入--no-django-db
pytest --tb=short -v -s看完整错误栈，重点盯django.core.management和django.db模块的报错行；再检查pytest --debug输出里的django_settings路径和database配置是否符合预期。测试数据库问题往往不是配置本身错，而是上下文（工作目录、Python路径、标记作用域）没对齐。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
