执行Django collectstatic遇OSError: [Errno 63]文件名过长，本地及Heroku均复现

问题根源 #

你的STATICFILES_DIRS配置存在语法错误，导致collectstatic错误遍历了整个项目根目录（包含db.sqlite3及已生成的staticfiles目录），进而引发无限嵌套的路径，最终触发文件名过长的OSError。

具体来说，原配置中：

STATICFILES_DIRS = [
    os.path.join(BASE_DIR), 'static'
]

这里把os.path.join(BASE_DIR)和'static'作为两个独立元素加入列表，相当于告诉collectstatic要收集整个BASE_DIR目录和当前目录下的static目录的内容。当collectstatic运行时，会遍历BASE_DIR下的所有文件（包括db.sqlite3），同时因为staticfiles目录位于BASE_DIR范围内，它会不断把staticfiles里的内容复制到新的staticfiles子目录中，形成无限嵌套的路径结构。

修正后的配置 #

将os.path.join的参数放在同一函数调用内，确保只指定项目的static目录：

PROJECT_ROOT = os.path.dirname(os.path.abspath(__file__))
STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(PROJECT_ROOT, 'staticfiles')
STATICFILES_DIRS = [
    os.path.join(BASE_DIR, 'static')  # 逗号放在join函数内部，合并为单个路径
]

额外注意事项 #

1. 确认BASE_DIR定义正确：通常在settings.py中，BASE_DIR应指向src目录（因为你的settings.py位于src/app下），标准定义为：

   BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
   

2. 运行collectstatic前，先删除已生成的staticfiles目录，避免残留的嵌套内容干扰新的收集流程。
3. 修正后，collectstatic只会收集static目录下的静态资源，不会再触碰db.sqlite3文件。

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