Shlink项目在Azure App Service中CLI工具无法连接生产数据库的解决方案

问题背景

在使用Shlink项目（一个开源的URL短链接服务）时，开发者在Azure App Service上部署了基于Docker镜像的Shlink服务，并配置了Microsoft SQL Server作为生产数据库。虽然REST API功能正常工作，但通过CLI工具执行命令时却遇到了数据库表不存在的错误。

问题现象

当通过SSH连接到运行在Azure App Service上的容器并尝试执行Shlink CLI命令（如shlink api-key:generate或shlink short-url:list）时，系统报错：

An exception occurred while executing a query: SQLSTATE[HY000]: General error: 1 no such table: api_keys

有趣的是，使用相同镜像和相同环境变量在本地运行时不出现此问题，且REST API功能完全正常。

根本原因分析

经过深入调查，发现问题根源在于通过SSH登录容器时环境变量的继承机制：

1. 环境变量丢失：通过SSH登录容器时，系统不会自动继承Docker容器中设置的环境变量
2. 配置加载失败：Shlink CLI工具依赖这些环境变量来正确配置数据库连接
3. 默认回退行为：当缺少必要的数据库配置时，Shlink会回退到使用SQLite内存数据库，导致找不到预期的表结构

解决方案

方案一：显式传递环境变量

修改SSH登录后的操作，手动加载环境变量：

# 在SSH会话中执行
export $(cat /proc/1/environ | tr '\0' '\n' | xargs)

此命令会从容器初始化进程(pid 1)中读取所有环境变量并设置到当前会话中。

方案二：修改SSH配置

在自定义Dockerfile中，修改SSH配置使其继承环境变量：

# 在Dockerfile中添加
RUN echo "PermitUserEnvironment yes" >> /etc/ssh/sshd_config
RUN mkdir -p /root/.ssh && touch /root/.ssh/environment

然后在启动脚本中导出需要的环境变量：

#!/bin/sh
echo "DB_DRIVER=$DB_DRIVER" >> /root/.ssh/environment
echo "DB_HOST=$DB_HOST" >> /root/.ssh/environment
# 其他必要环境变量...
/usr/sbin/sshd
exec /bin/sh ./docker-entrypoint.sh

方案三：使用Docker exec替代SSH

如果可能，尽量使用Docker原生命令进入容器：

docker exec -it container_name /bin/sh

这种方式会正确继承所有环境变量。

最佳实践建议

1. 环境变量管理：对于生产环境，考虑使用更专业的环境变量管理工具
2. 配置验证：在容器启动时添加配置验证步骤，确保所有必要变量已设置
3. 日志记录：增强日志记录，当配置加载失败时记录详细错误信息
4. 文档说明：在项目文档中明确说明通过不同方式进入容器时的行为差异

总结

在容器化环境中，不同的访问方式可能导致环境变量的继承行为不同。通过SSH访问容器时需特别注意环境变量的传递问题。本文提供的解决方案可以帮助开发者在Azure App Service或其他类似环境中正确使用Shlink CLI工具。理解这些底层机制对于在容器化环境中部署和维护应用至关重要。