为什么 DEBUG=False 设置会使我的 django 静态文件访问失败？

Question

我正在使用 Django 作为我的主力构建一个应用程序。到目前为止，一切都很顺利 - 指定的数据库设置、配置的静态目录、url、视图等。但是当我想要渲染自己漂亮的自定义 404.html 和 500.html 页面时，麻烦就开始出现了。

我阅读了有关自定义错误处理的文档，并在 UrlsConf 中设置了必要的配置，创建了相应的视图并将 404.html 和 500.html 添加到我的应用程序的模板目录（也在 settings.py 中指定）。

但文档说“您实际上可以查看自定义错误视图，直到调试关闭”，所以我确实将其关闭以测试我的东西，而那就是东西变得疯狂的时候！

我不仅无法查看自定义 404.html（实际上，它会加载，而且因为我的错误页面每个都包含一个图形错误消息 - 作为一些漂亮的图像），错误页面的源会加载，但不会加载其他内容！甚至没有链接 CSS 或 Javascript！

一般来说，一旦我设置 DEBUG = False，所有视图都会加载，但任何链接的内容（CSS、Javascript、图像等）都不会加载！发生什么事了？关于静态文件和 DEBUG 设置，是否缺少某些内容？

Answer 1

如果您仍然需要在本地提供静态服务（例如，为了不进行调试而进行测试），您可以在不安全模式下运行 devserver：

manage.py runserver --insecure

Answer 2

关闭调试后，Django 将不再为您处理静态文件 - 您的生产 Web 服务器（Apache 或其他）应该处理这个问题。

Answer 3

首先，您需要在 settings.py 中添加 STATIC_ROOT。

STATIC_ROOT = BASE_DIR / 'static'

确保 BASE_DIR 已定义。

然后，您需要在应用程序的根 urls.py 中添加以下代码。

from django.urls import re_path
from django.views.static import serve
from django.conf import settings


urlpatterns = [
    # your other paths here
    re_path(r'^media/(?P<path>.*)
然后您需要运行：
python manage.py collectstatic

 Lastly run:
python manage.py runserver

现在您应该能够加载静态文件。
, serve,{'document_root': settings.MEDIA_ROOT}),
    re_path(r'^static/(?P<path>.*)
然后您需要运行：

 Lastly run:

现在您应该能够加载静态文件。
, serve,{'document_root': settings.STATIC_ROOT}),
]

然后您需要运行：

Lastly run:

现在您应该能够加载静态文件。

Answer 4

您可以使用 WhiteNoise 在生产中提供静态文件。

安装：

pip install WhiteNoise==2.0.6

并将您的 wsgi.py 文件更改为：

from django.core.wsgi import get_wsgi_application
from whitenoise.django import DjangoWhiteNoise

application = get_wsgi_application()
application = DjangoWhiteNoise(application)

这样就可以开始了！

感谢 Handlebar 创意博客。

但是，确实不建议在生产中以这种方式提供静态文件。你的生产网络服务器（比如 nginx）应该处理这个问题。

Answer 5

约翰尼的答案很棒，但仅通过添加那里描述的那些行仍然对我不起作用。根据该答案，实际对我有用的步骤如下：

1. 安装 WhiteNoise 作为描述：

   pip 安装 WhiteNoise
   

2. 创建STATIC_ROOT 变量并将 WhiteNoise 添加到 settings.py 中的 MIDDLEWARE 变量：

   #settings.py
   中间件 = [
       'django.middleware.security.SecurityMiddleware',
       'whitenoise.middleware.WhiteNoiseMiddleware', #add Whitenoise
       'django.contrib.sessions.middleware.SessionMiddleware',
       ...
   ]
   
   #...
   
   STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles') ##指定静态根
   

3. 然后，按照约翰尼的回答中的说明修改您的 wsgi.py 文件：

   #wsgi.py
   从 django.core.wsgi 导入 get_wsgi_application
   从whitenoise.django导入DjangoWhiteNoise
   
   应用程序 = get_wsgi_application()
   应用程序 = DjangoWhiteNoise(应用程序)
   

4. 之后，将您的更改部署到您的服务器（使用 git 或您使用的任何工具）。

5. 最后，运行collectstatic< /a> 来自服务器上 manage.py 的选项。这会将静态文件夹中的所有文件复制到我们之前指定的 STATIC_ROOT 目录中：

   $ python manage.pycollectstatic
   

   您现在将看到一个名为 staticfiles 的新文件夹，其中包含此类元素。

执行这些步骤后，您现在可以运行服务器，并且能够在生产模式下查看静态文件。

更新：如果您的版本 4 changelog 表示不再需要声明 < code>WSGI_APPLICATION = 'projectName.wsgi.application' 在您的 settings.py 文件中。

Answer 6

如果您在开发中使用静态服务视图，则必须具有 DEBUG = True ：

警告

只有当 DEBUG 为 True 时，这才有效。

那是因为这个观点很严重
效率低下并且可能不安全。
这仅适用于本地
开发，并且永远不应该使用
正在生产中。

文档：在开发中提供静态文件

• 更新了链接，和这个

编辑：您可以添加一些网址来测试您的 404 和 500 模板，只需在您的网址中使用通用视图 direct_to_template 即可。

from django.views.generic.simple import direct_to_template

urlpatterns = patterns('',
    ('^404testing/
, direct_to_template, {'template': '404.html'})
)

Answer 7

实际上，您可以在生产 Django 应用程序中安全地提供静态文件，并且无需 DEBUG=True。

不要使用 Django 本身，而是在 WSGI 文件中使用 dj_static (github)：

requirements.txt：

...
dj-static==0.0.6

YOURAPP/settings.py：

...
STATIC_ROOT = 'staticdir'
STATIC_URL = '/staticpath/'

YOURAPP/wsgi.py：

...
from django.core.wsgi import get_wsgi_application
from dj_static import Cling

application = Cling(get_wsgi_application())

Answer 8

从这里我通过混合一些答案来寻求帮助。在这里，我添加了我的全部部分。 [我这样做是为了初学者的帮助以及我将来的使用]

首先，问题是为什么需要Debug=False！
我把我的项目放在AWS中，几个小时后由于内存泄漏，连接超时。
一开始我想到了芹菜。 【当然我只是个初学者】
然后我将 DEBUG=True 中的 DEBUG=False 正如我们可以在 settings.py 中看到的安全警告

# SECURITY WARNING: don't run with debug turned on in production!
DEBUG = True

一旦我这样做，我的静态文件就没有在网页中成功加载。
然后我到处搜索，首先尝试从这里使用 --insecure 命令来运行服务器。

python manage.py runserver --insecure

这是成功的，但我不希望我的项目在生产时使用不安全模式。
作为正确的解决方案[根据我]，我按照以下步骤操作。

首先，我更正 settings.py 中的静态 URL、root 和 dir

STATIC_URL = '/static/'
STATICFILES_DIRS = [os.path.join(BASE_DIR, 'static')]
STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')

然后通过命令收集静态文件

python manage.py collectstatic

现在是第二步，[此处也提供了]
首先在命令行中的项目目录中安装whitenoise

pip install whitenoise

，然后在settings.py中的中间件列表中添加“whitenoise.middleware.WhiteNoiseMiddleware”。

应该将其添加到“django.middleware.security.SecurityMiddleware”下方以及所有其余中间件上方。这样您的中间件列表将如下所示：-

MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware', #after this line
    'whitenoise.middleware.WhiteNoiseMiddleware', #add it exactlyhere
    'django.contrib.sessions.middleware.SessionMiddleware', #before this
    '...'
]

在已安装的应用程序顶部添加“whitenoise.runserver_nostatic” 这样您已安装的应用程序列表将如下所示：-

INSTALLED_APPS = [
    'whitenoise.runserver_nostatic',
    'django.contrib.admin',
    'django.contrib.auth',
    '...'
]

完成，您现在将能够在生产中提供静态文件！ [我也在我的本地环境中做了]

只需使用 runserver 命令，一如既往，没有不安全或任何需要的东西。

python manage.py runserver

繁荣！！！它对我有用。
哈哈哈。我知道我的天性有点幼稚，但我现在很高兴。

感谢在这里提供答案并帮助我的工作的所有人。

Answer 9

最终解决方案：-

所以基本上当你设置 debug = False 时，Django 不想处理你的静态文件。

所以我们想要一些可以处理我们的文件的东西。

答案是白噪声。

1. 在您的环境中安装白噪声

2. 在 settings.py 的中间件列表中添加'whitenoise.middleware.WhiteNoiseMiddleware'。

   应将其添加到'django.middleware.security.SecurityMiddleware'下方以及所有其余中间件上方。这样你的中间件列表将如下所示：-

   <前><代码>中间件 = [
   'django.middleware.security.SecurityMiddleware',
   'whitenoise.middleware.WhiteNoiseMiddleware',
   # 准确地添加到这里
   'django.contrib.sessions.middleware.SessionMiddleware',
   '...'
   ]

3. 在已安装的应用程序顶部添加'whitenoise.runserver_nostatic'
   这样您安装的应用程序列表将如下所示：-

   <前><代码>INSTALLED_APPS = [
   'whitenoise.runserver_nostatic',
   'django.contrib.admin',
   'django.contrib.auth',
   '...'
   ]

完成，您现在将能够在生产中提供静态文件！

Answer 10

您可以通过多种不同的方式对此进行调试。这是我的方法。

localsettings.py:

DEBUG = False
DEBUG404 = True

urls.py:

from django.conf import settings
import os

if settings.DEBUG404:
    urlpatterns += patterns('',
        (r'^static/(?P<path>.*)
请务必阅读文档;)
 https://docs.djangoproject.com/en/2.0/howto/static-files/#limiting-use-to-debug-true
, 'django.views.static.serve',
         {'document_root': os.path.join(os.path.dirname(__file__), 'static')} ),
    )

请务必阅读文档;)

https://docs.djangoproject.com/en/2.0/howto/static-files/#limiting-use-to-debug-true

Answer 11

这正是您必须在终端上键入才能运行项目而无需 DEBUG = TRUE
然后您会看到所有资产（静态）文件都在本地服务器上正确加载。

python manage.py runserver --insecure 

--insecure ：这意味着您可以在没有安全模式的情况下运行服务器

Answer 12

对于 Django 的最新版本，请查看此处的答案：https://stackoverflow.com/a/7639983/6180987

<对于低于 1.10 的 django 版本，解决方案应该有效：

只需打开项目 urls.py，然后找到此 if 语句。

if settings.DEBUG:
    urlpatterns += patterns(
        'django.views.static',
        (r'^media/(?P<path>.*)','serve',{'document_root': settings.MEDIA_ROOT}), )

您可以将 settings.DEBUG 更改为 True，它将始终有效。但如果您的项目是一个严肃的项目，那么您应该考虑上面提到的其他解决方案。

if True:
    urlpatterns += patterns(
        'django.views.static',
        (r'^media/(?P<path>.*)','serve',{'document_root': settings.MEDIA_ROOT}), )

在 django 1.10 中你可以这样写：

urlpatterns += [ url(r'^media/(?P<path>.*)
, serve, { 'document_root': settings.MEDIA_ROOT, }), url(r'^static/(?P<path>.*)
, serve, { 'document_root': settings.STATIC_ROOT }), ]

Answer 13

我同意 Marek Sapkota 的回答；但如果请求静态文件，您仍然可以使用 django URFConf 重新分配 url。

第 1 步：在 settings.py 中定义 STATIC_ROOT 路径

STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')

第 2 步：然后收集静态文件

$ python manage.py collectstatic

第 3 步：现在定义您的 URLConf，如果 static 位于 url 的开头，则从静态文件夹访问文件 <代码>静态文件。注意：这是您项目的 urls.py 文件：

from django.urls import re_path
from django.views.static import serve

urlpattern += [
  re_path(r'^static/(?:.*)
, serve, {'document_root': settings.STATIC_ROOT, })
]

Answer 14

当我设置 DEBUG = True 时，我的静态代码不起作用。

如果我在 python manage.py runserver --insecure 中运行我的项目。通过这个我也得到了我的静电。

解决方案 1：

python manage.py runserver --insecure

解决方案 2：

但我需要永久解决方案。然后我安装 pip install dj-static==0.0.6 并向我的 wsgi.py 文件添加一些代码：

from django.core.wsgi import get_wsgi_application
from dj_static import Cling

application = Cling(get_wsgi_application())

然后我在setting.py中添加一些代码：

STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, '/static/')
STATICFILES_DIRS = [
    BASE_DIR / "static",
]

Answer 15

我今天遇到了这个问题，并在开发过程中解决了这个问题，如果您仍然需要在本地提供静态服务（例如，用于不调试的测试），您可以在不安全模式下运行 devserver：

manage.py runserver --insecure

不用担心，因为在生产中，这个托管平台（Apache、Heroku ETC）将为您处理静态文件服务。

注意：Heroku 不提供静态文件，您希望将其放在 AWS 或 MS Azure 上

Answer 16

nginx、设置和 url 配置

如果您使用的是 Linux，这可能会有所帮助。

nginx file

your_machn:/#vim etc/nginx/sites-available/nginxfile

server {
    server_name xyz.com;

    location = /favicon.ico { access_log off; log_not_found off; }
    location /static/ {
        root /var/www/your_prj;
    }

    location /media/ {
        root /var/www/your_prj;
    }
...........
......
}

urls.py

.........
   .....
    urlpatterns = [
        path('admin/', admin.site.urls),
        path('test/', test_viewset.TestServer_View.as_view()),
        path('api/private/', include(router_admin.urls)),
        path('api/public/', include(router_public.urls)),    
        ]
    
    if settings.DEBUG:
        import debug_toolbar
        urlpatterns += static(settings.MEDIA_URL,document_root=settings.MEDIA_ROOT)
        urlpatterns += static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)

settings.py

.....
........
STATIC_URL = '/static/'
MEDIA_URL = '/media/'

STATIC_ROOT = os.path.join(BASE_DIR, 'static/')
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
.....
....

确保运行：

(venv)yourPrj$ ./manage.py collectstatic
yourSys# systemctrl daemon-reload

Answer 17

这是正常且有意的行为。

Warning

This will only work if DEBUG is True.  
you can actually view custom error views until Debug is Off  

如果 Django 只是从文件系统读取并发送文件，那么它比普通的 Web 服务器没有优势，所有 Web 服务器都能够自行提供文件服务。

此外，如果使用 Django 提供静态文件，Python 进程将在请求期间保持忙碌，并且无法提供更适合的动态请求。

由于这些原因，Django 静态视图仅设计用于开发期间使用，如果您的 DEBUG 设置为 False，则该视图将不起作用。

由于在开发过程中，我们通常一次只有一个人访问该站点（
开发人员），Django 可以很好地提供静态文件。

Answer 18

在生产模式下，静态文件不再由 Django 提供服务，而是应由 Apache 或 NGINX 提供服务，因此您需要配置它们。

另一方面，如果您想让 Django 为它们提供服务，那么下面的代码有助于在 DEBUG=False 时让 Django 提供静态文件。

您可以通过将以下代码附加到主 urls.py 文件来尝试：

from django.urls import re_path
from django.views.static import serve


urlpatterns += (
re_path(r'^media/(?P<path>.*)
然后，执行“collectstatic”：
python manage.py collectstatic

归功于 @stathoula。按照她的回答以及 @leopd 的评论（在她的回答中添加 re_path）。
, serve,{'document_root': settings.MEDIA_ROOT}),
re_path(r'^static/(?P<path>.*)
然后，执行“collectstatic”：

归功于 @stathoula。按照她的回答以及 @leopd 的评论（在她的回答中添加 re_path）。
, serve,{'document_root': settings.STATIC_ROOT}),
)

然后，执行“collectstatic”：

归功于 @stathoula。按照她的回答以及 @leopd 的评论（在她的回答中添加 re_path）。

Answer 19

对 url() 的字符串视图参数的支持已被弃用，并将在 Django 1.10 中删除

我的解决方案只是对上面 Conrado 解决方案的小修正。

from django.conf import settings
import os
from django.views.static import serve as staticserve

if settings.DEBUG404:
    urlpatterns += patterns('',
        (r'^static/(?P<path>.*)
, staticserve,
            {'document_root': os.path.join(os.path.dirname(__file__), 'static')} ),
        )

Answer 20

我对我的 project/urls.py 进行了以下更改，它对我有用

添加此行：
从 django.conf.urls 导入 url

并添加：
url(r'^media/(?P.*)$',serve, {'document_root':settings.MEDIA_ROOT, }),
在 url 模式中。

Answer 21

虽然这不是最安全的，但是你可以在源代码中进行更改。导航到 Python/2.7/site-packages/django/conf/urls/static.py

然后进行如下编辑：

if settings.DEBUG or (prefix and '://' in prefix):

那么如果 settings.debug==False 它将不会'对代码没有影响，运行后也尝试使用 python manage.py runserver --runserver 来运行静态文件。

注意：信息只能用于测试