如何解决Apache CGI中调用ALSA库snd_card_next无法获取MIDI声卡的问题

以下代码用于打印可用的ALSA MIDI声卡，本地执行时默认至少能识别到一个设备，但通过Apache CGI访问时，snd_card_next() 函数执行异常，触发首个错误判断分支，无法查询到任何ALSA声卡。

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <string.h>
#include <alsa/asoundlib.h>

#define NL  "\r\n"

void get_alsa_midi_cards(void)
{
    int card, status, cnt;
    int code;
    char *card_name;
    int i;
    
    card = -1;  // use -1 to prime the pump of iterating through card list
    status = snd_card_next(&card);
    if (status < 0 || card < 0) {
        printf ("Content-Type: text/html; charset=utf-8" NL "Cache-Control: no-cache" NL NL);
        printf("{\"alsa_midi_card\":[]}");
        //printf("Status: %i Card: %i", status, card);
        //printf("Status: 404 Not Found" NL NL);
        return;
    }   
    printf ("Content-Type: text/html; charset=utf-8" NL "Cache-Control: no-cache" NL NL);

    printf("{\"alsa_midi_card\":[");

    for (i = 0, cnt = 0; card >= 0; i++) {
        if ((code = snd_card_get_longname (card, &card_name)) < 0)
            continue;
        if (cnt++ > 0)
            printf(",");    
        printf("{\"longname\":\"");
        printf(card_name);
        printf("\"}");

        if ((status = snd_card_next (&card)) < 0)
            break;
    } 
    printf("]}");
} 

int main (int argc, char *argv[])
{
    get_alsa_midi_cards();

    return 0;
}

注意：使用gcc编译代码时，需添加-lasound参数，示例编译命令：gcc midi_card_query.c -o midi_card_query -lasound

• 权限不足：Apache CGI进程默认以www-data（Debian/Ubuntu）或apache（CentOS/RHEL）等低权限用户运行，该用户默认不在audio用户组，没有访问ALSA对应的设备节点/dev/snd/*、sysfs配置节点/sys/class/snd/*的权限，导致ALSA库调用失败。
• 安全模块拦截：多数发行版默认开启AppArmor或SELinux，会限制Apache进程访问硬件类资源，即使权限配置正确，也会被安全模块拦截。
• 环境变量缺失：CGI运行时会清理大部分环境变量，ALSA库依赖HOME、ALSA_CONFIG_PATH等环境变量加载配置，环境变量缺失会导致ALSA初始化失败。

• 验证权限问题：手动切换到Apache运行用户执行编译好的二进制程序，示例命令：sudo -u www-data ./midi_card_query，如果同样返回空列表，说明是权限问题，将Apache运行用户加入audio组即可：usermod -aG audio www-data，执行完成后重启Apache服务生效。
• 排查安全模块限制：查看系统日志，AppArmor日志位于/var/log/syslog，SELinux日志位于/var/log/audit/audit.log，如果存在Apache访问ALSA相关资源的拒绝记录，调整对应安全策略放行即可，也可临时关闭安全模块验证问题。
• 补全必要环境变量：在代码入口处添加ALSA依赖的环境变量，示例：

  int main (int argc, char *argv[])
  {
      // 补全ALSA依赖的环境变量
      setenv("ALSA_CONFIG_PATH", "/usr/share/alsa/alsa.conf", 1);
      setenv("HOME", "/var/www", 1);
      get_alsa_midi_cards();
      return 0;
  }
  

• 调试优化：可放开代码中注释的错误打印逻辑，配合snd_strerror(status)将错误码转为可读文本，更快定位具体问题。

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