Slim框架返回304等非200状态码时自定义HTTP头丢失如何解决？

304 Not Modified 属于HTTP协议定义的缓存类状态码，RFC 7232规范明确限制了该状态码下允许携带的HTTP头部范围，仅允许缓存相关、代理认证类头部存在，其余自定义头部、CORS相关头部都属于规范要求移除的范围。
Slim v4 框架的默认响应发射器（ResponseEmitter）严格遵循了该规范，会在返回304状态码时自动过滤掉所有非允许范围内的头部，这就是你设置的自定义头和CORS头丢失的核心原因。

根据你的业务场景可以选择两种方案：

方案1：调整业务状态码（推荐） #

304状态码的语义是「资源未修改，客户端可复用本地缓存」，本身不适合携带错误信息、自定义业务头。如果你的场景是返回业务错误/通知，建议更换为合适的4xx/5xx/2xx业务状态码，即可保留所有自定义头部，也符合HTTP语义规范。

方案2：自定义响应发射器保留指定头部 #

如果确实需要返回304状态码，你可以重写Slim默认的ResponseEmitter，在原有头部过滤逻辑执行后追加你需要保留的头部：

1. 首先实现自定义的响应发射器类

use Slim\ResponseEmitter;
use Psr\Http\Message\ResponseInterface;

class CustomResponseEmitter extends ResponseEmitter
{
    protected function emitHeaders(ResponseInterface $response, int $statusCode): void
    {
        // 预先存储需要保留的头部清单
        $allowCustomHeaders = [
            'Access-Control-Allow-Origin',
            'X-Error-Message',
            // 其他需要保留的自定义头都可以加在这里
        ];
        $reservedHeaders = [];
        foreach ($allowCustomHeaders as $headerName) {
            if ($response->hasHeader($headerName)) {
                $reservedHeaders[$headerName] = $response->getHeader($headerName);
            }
        }

        // 执行原有头部处理逻辑
        parent::emitHeaders($response, $statusCode);

        // 304状态下追加我们需要保留的自定义头
        if ($statusCode === 304) {
            foreach ($reservedHeaders as $headerName => $headerValues) {
                foreach ($headerValues as $headerValue) {
                    header(sprintf('%s: %s', $headerName, $headerValue), false);
                }
            }
        }
    }
}

2. 替换Slim默认的响应发射器
   在项目入口文件初始化Slim后，使用自定义的发射器输出响应：

use Slim\Factory\AppFactory;
use Slim\Psr7\Factory\ServerRequestFactory;

require __DIR__ . '/vendor/autoload.php';

$app = AppFactory::create();

// 你的路由、中间件等其他配置...

$request = ServerRequestFactory::createFromGlobals();
$response = $app->handle($request);

// 使用自定义发射器输出响应
$emitter = new CustomResponseEmitter();
$emitter->emit($response);

注意：该方案修改了HTTP规范默认的304头部规则，部分代理服务器可能仍会自动丢弃自定义头部，生产环境使用前需要做好兼容性测试。

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