Aspose.3D FOSS
TypeScript
Trikčių šalinimo vadovai

Trikčių šalinimo vadovai

Šiame puslapyje aptariamos dažniausiai pasitaikančios klaidos, su kuriomis susiduriama naudojant @aspose/3d TypeScript ir Node.js projektuose, pateikiant pagrindinių priežasčių paaiškinimus ir patikrintus sprendimus.

Modulio rezoliucijos klaidos

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

Pagrindinė priežastis: TypeScript modulio rezoliucijos strategija nepalaiko Node.js tipo sub‑kelio eksportų (exports faile package.json) nebent moduleResolution yra nustatyta į node arba node16.

Sprendimas: Nustatykite moduleResolution į "node" jūsų tsconfig.json:

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

Jei naudojate TypeScript 5.x su "module": "node16" arba "module": "nodenext", "moduleResolution": "node16" suderinti.

SyntaxError: Cannot use import statement in a module

Pagrindinė priežastis: Kompiliuotas JavaScript yra vykdomas su require() semantika, tačiau išvestis turi ES modulį import sintaksė; tai įvyksta, kai module nustatyta į es2020 arba esnext bet Node.js vykdymo aplinka tikisi CommonJS.

Ištaisyti: Naudoti "module": "commonjs" į tsconfig.json ir paleiskite sukompiliuotą .js failus su node tiesiogiai:

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

Tuomet sukompiliuokite ir vykdykite:

npx tsc
node dist/main.js

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

Pagrindinė priežastis: Paketas neįdiegtas arba node_modules yra pasenęs.

Ištaisyti:

npm install @aspose/3d

Patikrinkite įdiegimą:

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

Tuščia scena po įkėlimo

Scena įkelta, bet rootNode.childNodes yra tuščia

Pagrindinė priežastis (1): Failo formatas visą geometriją patalpina tiesiai ant rootNode.entity vietoj to kaip vaikų mazgų. Tai įprasta vieno tinklo STL failams.

Diagnostika:

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}`);

Pataisa: Naršyti pradedant nuo scene.rootNode pats, ne tik jo vaikai:

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);

Šakninė priežastis (2): Failo kelias neteisingas arba failas yra nulinio dydžio. Patikrinkite, ar failas egzistuoja ir nėra tuščias prieš iškviečiant 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}`);

Medžiagų sąrašas yra tuščias po OBJ įkėlimo

Šakninė priežastis: Medžiagos įkėlimas pagal numatymą išjungtas ObjLoadOptions. Biblioteka įkelia geometriją neskaitydama .mtl šoninio failo.

Pataisa: Nustatyti 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);

Taip pat įsitikinkite, kad .mtl failas yra tame pačiame kataloge kaip .obj failas, nes biblioteka jį nustato santykinai pagal .obj kelią.

Formato ir I/O klaidos

openFromBuffer išmeta neatpažintą formato klaidą

Šakninė priežastis: Buferio turinys nėra atpažįstamas dvejetainis formatas arba buferis yra sugadintas (trumpas, neteisingas kodavimas arba base64 vietoje neapdorotų baitų).

Diagnostika:

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

Ištaisyti: Tekstiniu pagrindu sukurtų formatų (OBJ, COLLADA) atveju, perduokite atitinkamą parametrų klasę, kad nurodytumėte formatą:

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

Išvesties GLB atveriamas kaip JSON 3D peržiūros programose

Pagrindinė priežastis: GltfSaveOptions.binaryMode numatytai yra false, generuojant .gltf JSON išvestis net kai išvesties failo pavadinimas yra .glb.

Pataisa: Aiškiai nustatyti binaryMode = true:

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

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

STL išvestis neturi spalvų ar medžiagų duomenų skaldiklyje

Pagrindinė priežastis: STL formatas nepalaiko medžiagų ar spalvų savo standartinėje specifikacijoje. Spalvų palaikymą turintys sliceriai naudoja nuosavybines plėtines, kurių nepalaiko @aspose/3d.

Pataisa: Eksportuokite į 3MF vietoj to, kuris palaiko spalvų ir medžiagų metaduomenis:

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

TypeScript kompiliacijos klaidos

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

Pagrindinė priežastis: Entity yra bazinė klasė; Mesh yra konkretus tipas su geometrijos savybėmis. Jums reikia instanceof apsaugos prieš prieigą prie tinklo specifinių narių.

Pataisa:

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'

Pagrindinė priežastis: getChildNode() grąžina Node | null. TypeScript griežtas režimas reikalauja, kad apdorotumėte null atvejį.

Ištaisyti:

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

Cannot find name 'GltfSaveOptions'

Pagrindinė priežastis: GltfSaveOptions yra subkelio modulyje @aspose/3d/formats/gltf, o ne paketo šaknies.

Pataisa: Importuoti iš subkelio:

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

Atminties ir našumo problemos

Procesas baigia darbą dėl trūkstamos atminties su dideliais FBX failais

Pagrindinė priežastis: Labai dideli FBX failai (>200 MB) paskiria reikšmingą heap. Node.js numatytoji heap yra ~1.5 GB 64‑bitų sistemose, tačiau gali būti nepakankama daugia‑scenos failams.

Pataisa:Padidinkite Node.js krūvos dydį:

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

Taip pat apdorokite failus nuosekliai, o ne lygiagrečiai, kai atmintis yra ribota:

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
}

Žiūrėti taip pat

 Lietuvių