在Django unittest环境中无法通过URL访问静态文件的求助

问题原因 #

Django的django.test.TestCase默认不会启用静态文件服务，因此测试客户端请求静态文件URL会返回404；而运行开发服务器时DEBUG=True会自动处理静态文件路由，所以浏览器可以正常访问。

解决方案 #

方案一：使用StaticLiveServerTestCase替代普通TestCase #

StaticLiveServerTestCase会启动真实的HTTP服务器，和开发服务器一样处理静态文件请求，适合需要验证静态文件访问的场景：

from django.contrib.staticfiles.testing import StaticLiveServerTestCase
from django.test import Client

class TestStaticFiles(StaticLiveServerTestCase):
    def test_static_file_access(self):
        client = Client()
        response = client.get('/static/datasets/static/datasets/images/Recursion Cellular Image Classification.jpeg')
        self.assertEqual(response.status_code, 200)

方案二：在普通TestCase中手动配置静态文件服务 #

如果不想切换测试类，可以通过临时设置DEBUG=True并添加静态文件路由来实现：

from django.test import TestCase, override_settings
from django.contrib.staticfiles.views import serve
from django.urls import path

class TestStaticFiles(TestCase):
    @override_settings(DEBUG=True)
    def test_static_file_access(self):
        # 临时添加静态文件处理路由
        self.client.handler.urlconf.urlpatterns.append(
            path('static/<path:path>', serve, {'insecure': True})
        )
        response = self.client.get('/static/datasets/static/datasets/images/Recursion Cellular Image Classification.jpeg')
        self.assertEqual(response.status_code, 200)

关于requests.get的适配 #

如果要用requests库请求静态文件，必须基于StaticLiveServerTestCase提供的live_server_url构造完整URL：

import requests
from django.contrib.staticfiles.testing import StaticLiveServerTestCase

class TestStaticFiles(StaticLiveServerTestCase):
    def test_static_file_with_requests(self):
        full_url = f"{self.live_server_url}/static/datasets/static/datasets/images/Recursion Cellular Image Classification.jpeg"
        response = requests.get(full_url)
        self.assertEqual(response.status_code, 200)

额外检查点 #

• 确认django.contrib.staticfiles已在INSTALLED_APPS中配置
• 确保STATIC_ROOT或STATICFILES_DIRS指向的路径下确实存在目标静态文件

内容的提问来源于stack exchange，提问作者Soulduck