Portfolio Performance项目创建新文件失败问题分析与解决方案

问题现象

Portfolio Performance是一款开源的金融投资组合管理软件，近期有用户报告在0.75.1版本中无法创建新的投资组合文件。该问题在Windows Subsystem for Linux (Ubuntu 20.04)和MacOS 15.4 (arm架构)环境下均有出现。

错误分析

从错误日志中可以观察到，当用户尝试通过"文件->新建"菜单或欢迎界面的创建新文件链接时，系统抛出java.lang.IllegalArgumentException异常。核心错误发生在CurrencyUnit.getDefaultInstance方法中，具体是在调用java.util.Currency.getInstance时失败。

根本原因

深入分析错误堆栈后，可以确定问题源于Java的货币类初始化过程。Portfolio Performance在创建新文件时需要设置基础货币，而这一过程依赖于Java的Currency类来获取系统默认货币设置。当Java无法确定当前系统的默认区域设置或货币类型时，就会抛出IllegalArgumentException。

这种情况在以下环境中尤为常见：

1. 非标准Linux环境（如WSL）
2. ARM架构的MacOS系统
3. 系统区域设置不完整或未正确配置的环境

解决方案

临时解决方案

对于遇到此问题的用户，可以采用以下临时解决方案：

1. 使用x86版本：在MacOS上，使用基于Intel架构的版本而非原生ARM版本可以规避此问题。

2. 手动设置系统区域：

   • 在Linux/WSL中，确保/etc/locale.gen文件包含正确的区域设置
   • 执行locale-gen命令生成区域设置
   • 设置LANG环境变量（如export LANG=en_US.UTF-8）

3. 通过现有文件修改：

   • 复制一个现有的portfolio文件
   • 修改其内容作为新文件使用

长期解决方案

从开发者角度，建议在代码层面进行以下改进：

1. 增强货币类容错处理：

   try {
       return Currency.getInstance(locale);
   } catch (IllegalArgumentException e) {
       // 提供默认货币选项
       return Currency.getInstance("USD");
   }
   

2. 改进新文件向导流程：

   • 在货币选择步骤提供明确的默认值
   • 增加货币选择失败的友好提示和手动选择选项

3. 完善平台兼容性测试：

   • 增加对WSL环境的测试用例
   • 加强对ARM架构MacOS的兼容性验证

技术背景

Java的Currency类依赖于系统的区域设置来提供货币信息。在标准的操作系统环境中，这些信息通常由系统配置提供。但在某些特殊环境（如WSL或某些容器环境）中，这些基础配置可能不完整，导致Java无法确定默认货币。

Portfolio Performance作为金融软件，货币单位是其核心功能的基础要素。创建新文件时必须确定基础货币，因此这一问题会直接影响软件的基本使用体验。

用户建议

对于普通用户，如果遇到此问题，可以：

1. 检查系统区域设置是否完整
2. 尝试在终端中运行locale命令，确认所有区域变量都已设置
3. 考虑使用更稳定的x86版本（特别是MacOS用户）
4. 等待官方发布修复版本

对于开发者用户，可以自行修改源代码，在CurrencyUnit类中添加更完善的错误处理逻辑，或者提供手动选择货币的选项来绕过系统自动检测。