为何Makefile目标中的命令退出码被忽略？

现象描述 #

在以下Makefile中执行make symfony-dump-assets时，即使php ./bin/console assetic:dump --quiet命令执行失败（返回退出码1），Make仍会继续执行而不终止，仅显示错误信息；但直接在交互式Shell中执行该命令时，会正确返回退出码1并终止。

SHELL=/bin/bash
PHP_CMD = php
CONSOLE_CMD = $(PHP_CMD) ./bin/console

.PHONY: symfony-dump-assets

symfony-dump-assets: ## Dump symfony assets.
    $(CONSOLE_CMD) assetic:dump --quiet

将CONSOLE_CMD改为使用绝对路径后，Make会正确捕获命令的非0退出码并终止执行：

CONSOLE_CMD = $(PHP_CMD) $(shell pwd)/bin/console

原因分析 #

这种差异通常由以下几个可能的原因导致：

• Shell环境差异
  交互式Shell会加载~/.bashrc、~/.profile等配置文件，可能包含别名、环境变量或自定义函数；而Make使用的是非交互式Shell，默认不会加载这些配置。如果你的php命令在交互式Shell中是一个别名（比如alias php='php -d some.config'），但在Make的Shell环境中使用的是原始php命令，可能导致脚本执行行为不同，进而影响退出码。

• 脚本路径解析与当前工作目录
  虽然./bin/console和$(shell pwd)/bin/console指向同一个文件，但Symfony的bin/console脚本可能依赖__DIR__或其他路径相关的逻辑。如果脚本中存在基于当前工作目录的相对路径加载（而非基于脚本自身目录），当Make在某些特殊场景下执行时（比如通过子目录调用Make），当前工作目录可能与预期不符，导致脚本错误处理逻辑异常，返回错误的退出码。

• 符号链接的解析差异
  如果./bin/console是一个符号链接，使用相对路径执行时，PHP可能会解析符号链接指向的原始文件路径，而某些依赖路径的逻辑可能因此出现偏差；使用绝对路径时，直接指向目标文件，避免了符号链接解析带来的路径差异，确保脚本的错误处理逻辑正常触发，返回正确的退出码。

• Make的命令拆分逻辑
  Make会将变量展开后的命令拆分为单词，如果路径中包含特殊字符（如空格），相对路径的写法可能导致命令拆分错误，间接影响命令的执行结果和退出码；使用绝对路径可以避免这种拆分歧义。

验证与解决 #

• 验证Shell环境差异：在Makefile中添加echo $(PHP_CMD)命令，对比交互式Shell和Make环境中php的实际执行路径和参数。
• 检查脚本路径逻辑：查看bin/console脚本中是否有依赖当前工作目录的代码，替换为基于__DIR__的绝对路径加载。
• 确认符号链接情况：使用ls -l ./bin/console查看是否为符号链接，若为符号链接，直接使用目标文件的绝对路径测试。

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