# Bug修复详细记录

## ADXP的Docker容器无法关闭的问题

### 问题描述

**现象**：
- 在 Ubuntu24.04 系统中部署的 ADXP 的 Docker 容器，启动后无法用 docker compose down 关闭
  - 错误提示：Error response from daemon: cannot stop container: adxp-adapter: permission denied

**错误原因**
- 由于apparmor软件的行为导致

**修复方法**

```sh
sudo apt purge --auto-remove apparmor
sudo service docker restart
docker system prune --all --volumes
```

** 其他可能的方案 **

```sh
sudo systemctl restart docker.socket docker.service
sudo docker image rm -f $(sudo docker image ls -q)
```

## 航班进出港通知定时任务不执行问题

### 问题描述

**现象**：
- 新增了航班进出港接口实现，但在日志中没有看到任何访问信息
- 服务端没有收到任何请求
- 其他所有定时任务接口都工作正常，只有航班进出港接口完全没有启动

**预期行为**：
- 定时任务应该每1秒执行一次
- 应该有日志输出显示API调用和数据处理过程
- 应该发布WebSocket事件

### 问题分析过程

#### 1. 初步排查 - 代码逻辑对比

对比正常工作的接口和不工作的接口实现：

**正常工作的接口**：
```java
// 航空器数据采集
@Scheduled(fixedRateString = "${data.collector.interval}")
public void collectAircraftData() {
    List<Aircraft> newAircrafts = dataCollectorDao.collectAircraftData(airportAircraftEndpoint, airportBaseUrl);
    // ...
}

// 车辆数据采集
@Scheduled(fixedRateString = "${data.collector.interval}")
public void collectVehicleData() {
    List<AirportVehicle> vehicles = dataCollectorDao.collectVehicleData(airportVehicleEndpoint, airportBaseUrl);
    // ...
}
```

**不工作的接口**：
```java
// 航班进出港通知采集
@Scheduled(fixedRateString = "${data.collector.flight-notification.interval}")
public void collectFlightNotificationData() {
    List<FlightNotificationDTO> notifications = dataCollectorDao.getFlightNotifications(flightNotificationEndpoint, airportBaseUrl);
    // ...
}
```

**发现差异**：参数传递模式相同，代码逻辑相同，唯一差异在配置键名。

#### 2. 配置分析 - Spring属性绑定问题

检查所有定时任务的配置键名：

**正常工作的配置**：
- `${data.collector.interval}` ✅
- `${data.collector.route.interval}` ✅
- `${data.collector.detection.interval:1000}` ✅

**不工作的配置**：
- `${data.collector.flight-notification.interval}` ❌

**关键发现**：连字符在嵌套属性中的问题！

#### 3. 配置文件结构分析

```yaml
data:
  collector:
    interval: 250                    # ✅ 工作正常
    route:                          # ✅ 工作正常
      interval: 5000
    detection:                      # ✅ 工作正常
      interval: 1000
    flight-notification:            # ❌ 不工作
      interval: 1000
```

**根本原因**：Spring Boot中@Value/@Scheduled表达式与@ConfigurationProperties对连字符的处理规则不同。

### Spring Boot配置绑定的两套规则

#### @ConfigurationProperties - 支持relaxed binding（宽松绑定）

```java
@ConfigurationProperties(prefix = "my.app")
public class MyProperties {
    private String firstName;  // 可以绑定 first-name
}
```

配置文件：
```yaml
my:
  app:
    first-name: "John"    # ✅ 支持连字符，会自动转换为firstName
```

#### @Value/@Scheduled - 直接属性解析，连字符限制

```java
@Scheduled(fixedRateString = "${my.app.first-name.interval}")  // ❌ 可能失败
@Value("${my.app.first-name.interval}")                       // ❌ 可能失败
```

**差异原因**：
- @ConfigurationProperties使用Spring的relaxed binding机制，会自动转换kebab-case到camelCase
- @Value和@Scheduled直接使用Environment.getProperty()，需要精确匹配属性路径
- 当属性路径中包含连字符时，可能影响属性解析器的路径分割逻辑

### 解决方案

#### 1. 修改配置文件

将连字符键名改为无连字符形式：

```yaml
# 修改前（不工作）
flight-notification:
  interval: 1000

# 修改后（正常工作）
flightnotification:
  interval: 1000
```

#### 2. 修改代码配置引用

```java
// 修改前
@Scheduled(fixedRateString = "${data.collector.flight-notification.interval:1000}")

// 修改后
@Scheduled(fixedRateString = "${data.collector.flightnotification.interval:1000}")
```

### 验证方法

#### 1. 添加调试日志验证定时任务执行

```java
@Scheduled(fixedRateString = "${data.collector.flightnotification.interval:1000}")
public void collectFlightNotificationData() {
    log.info("🔥 定时任务启动检查: 航班进出港通知采集任务执行中...");
    // ...
}
```

#### 2. 运行集成测试验证

测试结果显示调试日志成功输出：
```
🔥 定时任务启动检查: 航班进出港通知采集任务执行中...
✈️ 成功获取航班进出港通知数据，数量: 2
✈️ 采集到 2 条航班进出港通知
🛬 处理航班进出港通知: 航班号=CA8901, 类型=OUT, 跑道=35, 机位=201
📡 发布航班进出港通知WebSocket事件: 航班号=CA8901, 事件类型=TAKEOFF
✅ 航班进出港通知数据处理完成，处理数量: 2
```

### 最终修复文件

**修改的文件**：
1. `/qaup-admin/src/main/resources/application.yml` - 配置键名修改
2. `/qaup-collision/src/main/java/com/qaup/collision/datacollector/service/DataCollectorService.java` - 配置引用修改

**测试文件**：
- 集成测试验证功能正常工作
- 所有相关单元测试通过

### 经验教训

#### 1. Spring Boot配置最佳实践

- **避免在嵌套配置中使用连字符**：虽然YAML支持连字符，但Spring Boot的属性绑定机制在处理嵌套连字符属性时可能存在问题
- **优先使用驼峰命名或无连字符命名**：如`flightNotification`或`flightnotification`
- **为配置属性提供默认值**：使用`${key:defaultValue}`模式避免配置缺失导致的启动失败

#### 2. 连字符配置的使用场景

**推荐使用连字符的场景**：
- @ConfigurationProperties的类属性绑定
- 简单的顶级配置属性

**避免使用连字符的场景**：
- @Value注解中的嵌套属性路径
- @Scheduled注解中的配置引用
- 复杂的多级嵌套属性路径

#### 3. 问题排查方法论

1. **对比分析法**：对比正常工作和异常功能的实现差异
2. **逐层排查**：从代码逻辑 → 配置文件 → Spring机制
3. **添加调试日志**：在关键位置添加日志验证执行流程
4. **配置验证**：重点检查配置键名的命名规范

#### 4. 测试策略

- **不要仅依赖手动调用测试**：集成测试手动调用方法无法发现Spring调度问题
- **需要真实的Spring Boot环境测试**：只有在完整的Spring上下文中才能发现配置绑定问题
- **添加专门的调试日志**：临时添加明显的调试标识快速验证修复效果

### 相关技术点

#### Spring Boot属性绑定机制

Spring Boot使用`@ConfigurationProperties`和Environment抽象来绑定配置属性。对于嵌套属性：

- **支持的格式**：`data.collector.interval`、`data.collector.route.interval`
- **可能有问题的格式**：`data.collector.flight-notification.interval`
- **推荐格式**：`data.collector.flightnotification.interval`

#### @Scheduled注解机制

`@Scheduled`注解在Spring容器启动时进行解析：
1. Spring扫描所有带有`@Scheduled`的方法
2. 解析`fixedRateString`中的配置属性引用
3. 如果配置属性解析失败，该定时任务不会被注册
4. 不会抛出异常，只是静默跳过

这就是为什么其他接口正常工作，而配置有问题的接口完全没有日志输出的原因。

### 状态

- ✅ **问题已解决**
- ✅ **根本原因已确认**
- ✅ **修复方案已验证**
- ✅ **相关测试已通过**

**最终结果**：航班进出港通知定时任务现在每1秒正常执行，日志输出正常，WebSocket事件发布正常。