Aspose.3D FOSS
TypeScript
Ръководства за отстраняване на проблеми

Ръководства за отстраняване на проблеми

Тази страница обхваща най-често срещаните грешки, срещани при използване @aspose/3d в проекти с TypeScript и Node.js, с обяснения за причината и проверени решения.

Грешки при резолюция на модули

Error: Cannot find module '@aspose/3d/formats/obj'

Основна причина: Стратегията за резолюция на модули в TypeScript не поддържа експорти на подпътеки в стил Node.js (exports в package.json) освен ако moduleResolution е зададено на node или node16.

Поправка: Задай moduleResolution на "node" във вашия tsconfig.json:

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "moduleResolution": "node",
    "esModuleInterop": true,
    "strict": true
  }
}

Ако използвате TypeScript 5.x с "module": "node16" или "module": "nodenext", използвайте "moduleResolution": "node16" за съвпадение.

SyntaxError: Cannot use import statement in a module

Основна причина: Компилираният JavaScript се изпълнява с require() семантика, но изходът съдържа ES модул import синтаксис; това се случва, когато module е зададено на es2020 или esnext но средата за изпълнение на Node.js очаква CommonJS.

Поправка:Използвайте "module": "commonjs" в tsconfig.json и изпълнете компилираните .js файлове с node директно:

{
  "compilerOptions": {
    "module": "commonjs",
    "outDir": "./dist"
  }
}

След това компилирайте и изпълнете:

npx tsc
node dist/main.js

Error: Cannot find module '@aspose/3d'

Основна причина: Пакетът не е инсталиран, или node_modules е остарял.

Поправка:

npm install @aspose/3d

Проверете инсталацията:

node -e "const { Scene } = require('@aspose/3d'); console.log('OK', new Scene().constructor.name);"

Празна сцена след зареждане

Сцената се зарежда, но rootNode.childNodes е празна

Основна причина (1): Форматът на файла поставя цялата геометрия директно върху rootNode.entity вместо като дъщерни възли. Това е често срещано при едномрежови STL файлове.

Диагноза:

import { Scene, Mesh } from '@aspose/3d';

const scene = new Scene();
scene.open('model.stl');

// Check rootNode directly
if (scene.rootNode.entity) {
    console.log(`Root entity: ${scene.rootNode.entity.constructor.name}`);
}
console.log(`Child count: ${scene.rootNode.childNodes.length}`);

Поправка: Обхождане, започвайки от scene.rootNode самият, а не само неговите деца:

function visit(node: any): void {
    if (node.entity instanceof Mesh) {
        const m = node.entity as Mesh;
        console.log(`Mesh: ${m.controlPoints.length} vertices`);
    }
    for (const child of node.childNodes) {
        visit(child);
    }
}
visit(scene.rootNode);

Основна причина (2): Пътят към файла е грешен или файлът е нулев размер. Проверете дали файлът съществува и не е празен, преди да извикате open().

import * as fs from 'fs';

const path = 'model.obj';
if (!fs.existsSync(path)) throw new Error(`File not found: ${path}`);
const stat = fs.statSync(path);
if (stat.size === 0) throw new Error(`File is empty: ${path}`);

Списъкът с материали е празен след зареждане на OBJ

Основна причина: Зареждането на материали е изключено по подразбиране в ObjLoadOptions. Библиотеката зарежда геометрията, без да чете .mtl страничен файл.

Поправи: Задай enableMaterials = true:

import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';

const scene = new Scene();
const opts = new ObjLoadOptions();
opts.enableMaterials = true;
scene.open('model.obj', opts);

Също така уверете се, че .mtl файлът е в същата директория като .obj файл, тъй като библиотеката го разрешава относително спрямо .obj пътя.

Грешки във формат и I/O

openFromBuffer хвърля грешка за неразпознат формат

Основна причина: Съдържанието на буфера не е разпознаваем двоичен формат или буферът е повреден (отсечен, с грешно кодиране или base64 вместо сурови байтове).

Диагноза:

const buffer = fs.readFileSync('model.glb');
console.log('Buffer size:', buffer.length, 'bytes');
console.log('First 4 bytes (hex):', buffer.slice(0, 4).toString('hex'));
// GLB magic: 676c5446 ("glTF")
// STL binary starts with 80 bytes of header; no fixed magic
// OBJ is text: openFromBuffer may not detect format

Поправка: За текстови формати (OBJ, COLLADA) предайте съответния клас с опции, за да подсказвате формата:

import { ObjLoadOptions } from '@aspose/3d/formats/obj';
scene.openFromBuffer(buffer, new ObjLoadOptions());

Изходният GLB се отваря като JSON в 3D прегледачи

Основна причина: GltfSaveOptions.binaryMode по подразбиране е false, създавайки .gltf JSON изход дори когато името на изходния файл е .glb.

Поправка: Изрично зададено binaryMode = true:

import { GltfSaveOptions } from '@aspose/3d/formats/gltf';

const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save('output.glb', opts);

STL изходът няма данни за цвят или материал в слайсера

Основна причина: Форматът STL не поддържа материали или цвят в своята стандартна спецификация. Слайсъри, поддържащи цвят, използват собствени разширения, които не се поддържат от @aspose/3d.

Поправка: Експортирайте в 3MF вместо това, което поддържа цвят и метаданни за материали:

scene.save('output.3mf');

Грешки при компилация на TypeScript

Property 'controlPoints' does not exist on type 'Entity'

Основна причина: Entity е базовият клас; Mesh е конкретният тип с геометрични свойства. Трябва ви instanceof защита преди достъп до членове, специфични за мрежата.

Поправка:

import { Mesh } from '@aspose/3d';

if (node.entity instanceof Mesh) {
    const mesh = node.entity as Mesh;
    console.log(mesh.controlPoints.length);
}

Type 'null' is not assignable to type 'Node'

Основна причина: getChildNode() връща Node | null. Строгият режим на TypeScript изисква да обработите случая с null.

Поправка:

const child = node.getChildNode('wheel');
if (!child) throw new Error('Node "wheel" not found');
// child is now Node, not null

Cannot find name 'GltfSaveOptions'

Основна причина: GltfSaveOptions се намира в подпътя module @aspose/3d/formats/gltf, а не в корена на пакета.

Поправка: Импорт от подпътя:

import { GltfSaveOptions } from '@aspose/3d/formats/gltf';

Проблеми с паметта и производителността

Процесът изчерпва паметта при големи FBX файлове

Основна причина: Много големи FBX файлове (>200 MB) заделят значителен хип. По подразбиране Node.js използва хип около ~1.5 GB на 64‑битови системи, но това може да не е достатъчно за файлове с множество сцени.

Поправка: Увеличете размера на хипа на Node.js:

node --max-old-space-size=8192 dist/convert.js

Също така обработвайте файловете последователно, а не паралелно, когато паметта е ограничена:

for (const file of files) {
    const scene = new Scene();
    scene.open(file);
    scene.save(file.replace('.fbx', '.glb'));
    // scene goes out of scope; GC can reclaim
}

Вижте също

 Български