我之前也踩过这个一模一样的坑！问题根源其实出在你的.env文件格式上，下面一步步给你解决：

1. 修正.env文件的变量定义格式 #

Docker Compose的.env文件遵循Shell环境变量的键值对规则，必须用=来分隔变量名和值，而不是你用的:。把你的.env内容从：

port:3306

改成：

port=3306

这是最关键的一步——冒号分隔的写法完全不被Docker Compose识别，所以它才会提示port变量未设置，默认是空字符串。

2. 验证变量是否正确加载 #

修改完后，先别急着启动容器，用docker-compose config命令检查解析后的配置：

docker-compose config

如果变量加载正常，你会看到services.mariadb.ports字段显示为3306:3306，而不是报错里的空冒号:。

3. 额外排查（如果还是有问题） #

如果上述操作后仍然报错，可以检查这几个点：

• 确认.env文件和docker-compose.yml在同一目录下；如果你的.env在其他路径，启动时需要用--env-file指定，比如：docker-compose --env-file ./configs/my.env up
• 避免变量定义里的多余空格，比如port = 3306（等号两边有空格），虽然Shell允许，但可能导致解析异常，尽量写成port=3306
• 检查Docker Compose版本：确保你使用的是v1.28.0及以上版本（这个版本开始默认支持自动加载同目录的.env文件）

为什么会出现这个错误？ #

你看到的警告WARNING: The port variable is not set. Defaulting to a blank string.是因为Docker Compose没识别到port变量，于是把它设为空；而错误ERROR: The Compose file './docker-compose.yml' is invalid because: services.mariadb.ports is invalid是因为空变量导致ports字段变成了:，完全不符合Docker端口的格式要求（格式应为[远程IP:]远程端口:本地端口[/协议]）。

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