PyCharm运行Django报(root) Additional property django is not allowed错误求助

问题根因 #

你遇到的报错是PyCharm 2021版本与Docker Desktop默认启用的Docker Compose V2不兼容导致的：

• Docker Desktop 4.0+默认开启Compose V2，移除了对旧版Compose语法的部分兼容校验，该配置通常会在Docker后台自动更新或静默重启后生效，所以你未修改项目代码也会突然触发故障
• 2021版PyCharm未适配Compose V2的配置解析规则，无法正确识别docker-compose.yaml中services下定义的服务，因此抛出配置属性不合法的报错，同时解释器设置的Service下拉框无法加载出对应服务选项

解决方案 #

按优先级从高到低尝试即可：

1. 禁用Docker Compose V2
   打开Docker Desktop设置，进入General页签，取消勾选Use Docker Compose V2，保存后重启Docker Desktop，再重启PyCharm即可恢复正常
2. 升级PyCharm版本
   若需要使用Compose V2特性，将PyCharm升级到2022.2及以上版本，这些版本已完成Compose V2的适配
3. 指定Compose V1执行路径
   打开PyCharm的Preferences > Build, Execution, Deployment > Docker > Tools，将Docker Compose executable改为旧版的docker-compose（而非默认的docker compose），保存设置后重启PyCharm

验证方式 #

修改配置后，先在终端进入项目目录执行以下命令，确认配置本身无问题：

docker-compose config

执行无报错后再在PyCharm中加载远程解释器，即可看到django服务出现在Service下拉列表中

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